Настройка · Lingo.dev

Установите CLI Lingo.dev, настройте проект и получите первые переводы.

Что понадобится

Требуется Node.js 18 или выше. Выполните node -v, чтобы проверить версию.

Шаг 1. Инициализируйте проект#

Перейдите в каталог проекта

bash

cd your-project-directory

Запустите команду init

bash

npx lingo.dev@latest init

Пользователи Windows: если npx lingo.dev не работает, сначала установите пакет с помощью npm install lingo.dev@latest, а затем используйте npx lingo.

Следуйте подсказкам. CLI создаст файл конфигурации i18n.json в корне проекта.

Шаг 2. Настройте bucket#

В i18n.json настройте как минимум один bucket — формат файла в связке с include-шаблонами, которые подсказывают CLI, где находится переводимый контент:

json

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

Заполнитель [locale] во время выполнения подставляет настроенные коды локалей: locales/en.json для исходного языка, locales/es.json для испанского и так далее.

Полный список поддерживаемых форматов файлов и конфигураций bucket см. в разделе Supported Formats.

Шаг 3. Подключите бэкенд перевода#

Чтобы генерировать переводы, CLI нужен бэкенд перевода. Есть два варианта:

Движок локализации на Lingo.dev автоматически применяет тональность бренда, глоссарий, правила и конфигурацию модели к каждому запросу на перевод.

Создайте аккаунт и сгенерируйте API-ключ на странице API Keys.
Укажите API-ключ в переменной окружения:

bash

export LINGO_API_KEY="your-api-key"

Дополнительная настройка не нужна — CLI использует движок локализации вашей организации по умолчанию. Чтобы выбрать конкретный движок, добавьте engineId в i18n.json:

json

{
  "engineId": "eng_SxjMwMsfOIsvV1wh"
}

Шаг 4. Сгенерируйте переводы#

bash

npx lingo.dev@latest run

CLI находит исходные файлы, извлекает переводимый контент, отправляет его в настроенный бэкенд перевода и записывает результат обратно на диск. Для отслеживания уже переведённого создаётся файл i18n.lock — закоммитьте его вместе с файлами локалей.

Что дальше#

i18n.json

Полный справочник по конфигурации

Supported Formats

JSON, YAML, Markdown и более 20 форматов файлов

Подключите свой движок

Направляйте переводы через свой движок локализации

Как это работает

Пятиэтапный пайплайн перевода