Конфигурация CLI v0
Настройте бакеты, пути локалей и сервисы перевода для устаревшей версии, не смешивая поколения конфигурации.
lingo.dev@0.138.10 читает i18n.json из рабочего каталога. Бакет задаёт парсер и определяет, какие файлы искать, а настройки локалей — исходную и целевые локали. Эти правила настройки отличаются от правил текущего .lingo/config.json.
Задайте локали и бакеты #
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
},
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}Пути определяются относительно файла конфигурации. Парсер выбирается по ключу бакета, а не по расширению файла. Если формат хранит несколько локалей в одном файле, сверьтесь с таблицей форматов и вывода для устаревшей версии.
Поле version указывает поколение схемы. Миграция устаревшей схемы может обновить этот файл без перехода на текущую версию CLI. Сохраните предыдущую конфигурацию и проверьте все автоматически внесённые изменения.
Внимательно настройте сопоставление путей #
Вместо [locale] подставляется код исходной или целевой локали. Для каждого пути можно задать разделитель, чтобы использовать имена файлов с подчёркиваниями:
{
"include": [
"standard/[locale].json",
{ "path": "legacy/[locale].json", "delimiter": "_" }
]
}Для en-US во втором пути используется legacy/en_US.json. Запись локали в имени файла не связана с нормализованными значениями локали, которые отправляются сервису.
Рекурсивный поиск ** доступен начиная с 0.135.0. В более ранних версиях пути нужно указывать явно. По умолчанию рекурсивный поиск исключает node_modules, .git, dist, build, .next и .turbo. Добавьте исключения для других автоматически создаваемых деревьев каталогов.
Настройте поведение ключей #
В устаревшей версии настройки ключей используют обход по путям с косой чертой в качестве разделителя и сопоставление с подстановочными знаками. modules/ai.translation выбирает внутри modules ключ с точками в имени, трактуя его буквально. Блокировка копирует исходные значения, игнорирование исключает их из вывода, а сохранение заполняет отсутствующие значения из источника и затем оставляет их для ручного редактирования. injectLocale выбирает ключи вывода для кода целевой локали.
Подробности о том, как работает каждая настройка, см. в разделе Управление ключами. Инструкция по переводу не защищает структуру, а текст-заглушку на исходном языке перед использованием всё равно нужно перевести вручную.
Выберите движок локализации или прямое подключение к провайдеру #
При использовании учётных данных Lingo.dev параметр engineId выбирает глоссарий, правила, стиль и модели движка локализации. Лучше указывать его явно. Без него выбор определяется политикой сервиса, а не ссылкой на фиксированную конфигурацию. Текущий сервис может потребовать ИД или выбрать самый старый из включённых движков локализации, доступных ключу.
Для прямого подключения к провайдерам используются ИД провайдера, модель и промпт. Ниже показан устаревший формат настройки. Это не рекомендация использовать указанную модель: она может быть уже недоступна:
{
"provider": {
"id": "openai",
"model": "gpt-4o-mini",
"prompt": "Translate the provided text from {source} to {target}."
}
}В промпте вместо {source} и {target} подставляются коды локалей. Не рассчитывайте, что provider.baseUrl перенаправит запросы run от lingo.dev@0.138.10. При работе с OpenAI передаётся baseUrl, но закреплённая версия зависимости провайдера читает baseURL, поэтому это значение конфигурации игнорируется. Вместо него зависимость поддерживает OPENAI_BASE_URL. Прежде чем отправлять контент или учётные данные, убедитесь, что адрес назначения верный. При работе с Ollama параметр provider.baseUrl тоже игнорируется, а провайдер создаётся с настройками по умолчанию. Его сервис должен быть доступен из среды выполнения. Удалённая среда выполнения не может использовать адрес localhost ноутбука.
| Сервис | Учётные данные |
|---|---|
| Lingo.dev | LINGO_API_KEY |
| OpenAI | OPENAI_API_KEY |
| Anthropic | ANTHROPIC_API_KEY |
GOOGLE_API_KEY | |
| Mistral | MISTRAL_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| Локальная Ollama | При локальной настройке ключ API провайдера не нужен. |
LINGO_API_URL меняет адрес сервиса Lingo.dev. При этом всё равно нужно проверить совместимость и убедиться, что новому адресу можно доверять. Не храните учётные данные в конфигурации и логах. После смены сервиса или правил поиска файлов повторите небольшой пробный запуск на первом файле. Смена модели или промпта не меняет отпечатки исходного текста. Поэтому, если вы хотите обновить уже переведённый текст, нужно явно запустить обновление.