Переведите свой первый файл

Создайте каталог исходных текстов, получите файлы на немецком и французском, а затем переведите изменения в исходном тексте.

В этом руководстве вы настроите проект, переведёте один JSON-файл с английского и получите результат. В итоге у вас будут файлы на целевых языках на диске и основа для дальнейших правок. Если хотите поручить настройку агенту для работы с кодом, см. Настройка с помощью агента для работы с кодом.

Для работы нужна небольшая папка проекта, а также доступные Node.js и npm. Ещё понадобятся учётная запись Lingo.dev, право переводить с помощью включённого движка локализации и достаточный остаток лимита на учётной записи.

Установите и войдите в учётную запись #

sh
npm install --global @lingo.dev/cli
lingo --version
lingo login

При входе открывается браузер. Для неинтерактивного запуска вместо этого передайте LINGO_API_KEY через хранилище секретов среды запуска. Ключ из переменной окружения имеет приоритет над сохранёнными данными входа. Поэтому перед входом под другой учётной записью удалите ключ из окружения, если он не должен использоваться.

Создайте исходный файл #

Создайте папку locales и сохраните этот текст в файле locales/en.json:

json
{
  "checkout": {
    "title": "Review your order",
    "submit": "Place order"
  }
}

В корне проекта выполните:

sh
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo link

init записывает .lingo/config.json и добавляет блок Lingo.dev в AGENTS.md, чтобы агенты для работы с кодом знали, что нужно прочитать руководства для агентов по CLI. Чтобы пропустить этот шаг, передайте --no-agents-md. link позволяет выбрать организацию и движок локализации или создать их, если у вас есть нужные права. Движок локализации определяет модели и языковые рекомендации. Его ИД сохраняется в конфигурации проекта, а ваши учётные данные хранятся отдельно.

Прежде чем продолжить, откройте конфигурацию. В ней должны быть указаны en как исходный язык, de и fr как целевые языки, а locales/en.json — как исходный файл. Проверьте также ИД организации и движка локализации, особенно если вы работаете с копией проекта или форком.

Переведите и получите файлы #

sh
lingo push --backfill-missing --wait

Дозаполнение запрашивает недостающие целевые файлы. --wait дожидается завершения и скачивает готовый результат. Обычный первый push без Lockfile сохраняет исходные данные, но не запрашивает первоначальный перевод.

Не меняйте целевые файлы, пока команда ожидает результат: при таком прямом получении файлов, в отличие от отдельной команды pull, не выполняется новая проверка конфликтов с локальными изменениями. Если запуск ожидает проверки или сообщает об ошибках, сначала разберитесь с его состоянием и только потом считайте его завершённым.

Откройте locales/de.json и locales/fr.json. Убедитесь, что оба ключа checkout на месте, и прочитайте переведённые значения. Если вы не можете оценить перевод на целевой язык, обратитесь к квалифицированному специалисту по проверке или используйте подходящий метод оценки. При интеграции с приложением также загрузите файлы через его обычный загрузчик ресурсов.

Проверьте .lingo/lock.json вместе с изменениями в исходном и целевых файлах. Сохраните одобренные файлы, конфигурацию и базовое состояние в одном коммите. Если вы не использовали --wait, позже выполните lingo pull из того же checkout и на том же компьютере, чтобы получить результаты последнего локально записанного запуска.

Обновите исходный файл #

Измените значение или добавьте ключ в locales/en.json, затем выполните:

sh
lingo push --wait

При обычном обновлении изменения исходного файла сравниваются с сохранённым базовым состоянием. Дозаполнение предназначено для недостающих файлов, а не для новых ключей в уже существующем целевом файле.

Для других типов ресурсов или структур файлов см. разделы Конфигурация и Форматы. Для YAML и Android XML нужно явно выбрать формат. Чтобы извлекать вызовы из исходного кода React, перейдите к краткому руководству по React. Выберите его каталог JSONC в конфигурации: не рассчитывайте, что этот пример JSON-файла выберет его автоматически.