Локализация статического контента

Lingo.dev CLI переводит статические файлы в вашем репозитории — Markdown, MDX, Markdoc, JSON, YAML, субтитры и многое другое — через настроенный движок локализации. Просто укажите путь к контенту, запустите команду один раз и получите переведённые файлы рядом с исходниками.

Поддерживаемые типы контента#

CLI определяет формат каждого файла по расширению — тип хранилища настраивать не нужно. Локаль задаётся прямо в пути (content/en/x.md превращается в content/de/x.md), так что плейсхолдер [locale] не нужен.

Полный список поддерживаемых форматов — в справочнике форматов.

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

При каждом запуске контент проходит через движок локализации — он определяет, какая языковая модель, глоссарий, тональность бренда и правила используются. Создайте движок в панели управления Lingo.dev и настройте CLI (Node 22+):

npm install -g @lingo.dev/cli
lingo login
lingo init
lingo link

lingo init и lingo link создают .lingo/config.json, связывая CLI с вашей организацией и движком. Зафиксируйте этот файл в репозитории — тогда все окружения будут использовать одну конфигурацию.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "docs/en/getting-started.md" }]
}

В CI пропустите lingo login и передайте LINGO_API_KEY как переменную окружения. Сгенерировать её можно в разделе API-ключей.

Сайты с документацией#

Большинство фреймворков для документации хранят переводы в отдельных директориях для каждой локали. Добавьте паттерн для каждого исходного файла (или глоб) в files. CLI сохраняет frontmatter, блоки кода и синтаксис компонентов, переводя Markdown, MDX и Markdoc.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [
    { "pattern": "docs/en/getting-started.md" },
    { "pattern": "docs/en/setup.mdx" }
  ]
}

Запустите первый перевод, заполнив все целевые локали:

lingo push --backfill-missing

При следующих запусках lingo push переводит только то, что изменилось. Используйте lingo pull, чтобы получить переводы, созданные в другом месте.

Скорректируйте путь к источнику под структуру директорий вашего фреймворка:

Структурированные данные#

JSON и YAML переводятся автоматически по расширению. Используйте управление ключами, чтобы защитить непереводимые значения (идентификаторы, URL, флаги конфигурации) от изменений.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [
    { "pattern": "content/en.json" },
    { "pattern": "data/en.yaml" }
  ]
}

Для обычного YAML поле format не нужно. Явно указать yaml-openapi в записи файла требуется только для yaml-root-key, android и "format".

Субтитры#

SRT-файлы субтитров переводятся по расширению. CLI сохраняет все тайминги, индексы реплик и теги форматирования — переводится только текст.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "subs/en/intro.srt" }]
}

Работа с большим объёмом контента#

Статические репозитории контента могут содержать тысячи файлов. CLI справляется с этим без проблем:

Чтобы проверить актуальность переводов без записи файлов — удобно как CI-проверка — запустите lingo check.

Что дальше#