Установите CLI Lingo.dev, настройте проект и получите первые переводы.
Что понадобится
Требуется Node.js 18 или выше. Выполните node -v, чтобы проверить версию.
Шаг 1. Инициализируйте проект#
Перейдите в каталог проекта
cd your-project-directoryЗапустите команду init
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, где находится переводимый контент:
{
"$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 автоматически применяет тональность бренда, glossary, instructions и model configuration к каждому запросу на перевод.
Создайте аккаунт и сгенерируйте API-ключ на странице API Keys.
Укажите API-ключ в переменной окружения:
export LINGO_API_KEY="your-api-key"Дополнительная настройка не нужна — CLI использует движок локализации вашей организации по умолчанию. Чтобы выбрать конкретный движок, добавьте engineId в i18n.json:
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Шаг 4. Сгенерируйте переводы#
npx lingo.dev@latest runCLI находит исходные файлы, извлекает переводимый контент, отправляет его в настроенный бэкенд перевода и записывает результат обратно на диск. Для отслеживания уже переведённого создаётся файл i18n.lock — закоммитьте его вместе с файлами локалей.
