Как перевести файл с помощью CLI v0

Воспроизведите перевод небольшого каталога в старой версии с зафиксированной версией пакета и проверьте результат и Lockfile.

Эта инструкция подойдёт для проекта с установленным i18n.json или отдельного тестового проекта на старой версии. Она рассчитана на lingo.dev@0.138.10, для которого в манифесте указан Node.js 18 или новее. Сначала проверьте node --version и установленный lingo --version. Для новых проектов используйте актуальное руководство по быстрому запуску.

Используйте зафиксированный пакет #

В существующем проекте оставьте зафиксированную версию зависимости. Для отдельного тестового проекта выберите менеджер пакетов, которым пользуетесь:

sh
npm install --save-dev lingo.dev@0.138.10
pnpm add --save-dev lingo.dev@0.138.10
yarn add --dev lingo.dev@0.138.10
bun add --dev lingo.dev@0.138.10

Выполните только одну команду установки. Запускайте локальный исполняемый файл через npm exec -- lingo, pnpm exec lingo, yarn lingo или bun run lingo. В примерах ниже для краткости используется lingo. В Windows локальная установка зафиксированной версии и запуск через исполняемый файл менеджера пакетов также позволяют не полагаться на поиск команды по имени пакета.

Создайте каталог и конфигурацию #

Выполните lingo init из папки, в которой должен находиться проект. Команда создаёт i18n.json. Если файл уже есть, сохраните его, а не инициализируйте заново. Создайте locales/en.json:

json
{
  "welcome": "Welcome back",
  "button.save": "Save changes"
}

Используйте соответствующую группу JSON:

json
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": { "source": "en", "targets": ["es"] },
  "buckets": {
    "json": { "include": ["locales/[locale].json"] }
  }
}

version — это версия схемы конфигурации, а не пакета. Этот шаблон читает английский текст из locales/en.json и записывает испанский перевод в locales/es.json.

Настройте сервис перевода #

Для Lingo.dev передайте LINGO_API_KEY через механизм работы с секретами в вашей оболочке. Добавьте нужный engineId в конфигурацию и убедитесь, что ключ позволяет переводить через этот движок локализации. Если не указать его, сервис выберет движок неявно. При этом текущая политика сервиса может требовать явного указания ИД.

Прямое подключение к провайдеру в v0 — отдельный вариант настройки. Для него нужны учётные данные провайдера или доступный сервис Ollama. Описание полей есть в справочнике по конфигурации. Эти поля не предназначены для JSON-конфигурации текущего CLI.

Запустите и проверьте #

sh
lingo run

Проверьте в locales/es.json и ключи, и сами переведённые значения. Убедитесь, что сообщение о сохранении по-прежнему называет нужное действие. При подключении к приложению загрузите целевой каталог через загрузчик, который приложение использует на практике. Сохраните одобренный результат, конфигурацию и i18n.lock в одном коммите.

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

Во время разработки lingo run --watch отслеживает изменения исходного текста, пока вы не остановите его с помощью Ctrl+C. Прежде чем расширять тестовый проект, изучите использование существующих переводов и ручное управление целевыми переводами.