Как организовать работу с CLI v0 в монорепозитории

Выберите общую конфигурацию или отдельную для каждого пакета и сохраняйте связь каждого результата перевода в старой версии CLI с его базовой версией исходных данных.

Используйте один i18n.json в корне, если у пакетов общие исходный язык, целевые языки и сервис перевода. Для пакетов с отдельными правилами или ответственными используйте отдельные файлы. У каждой конфигурации свой i18n.lock.

Найдите общий макет в корневой конфигурации #

Рекурсивные шаблоны в 0.135.0 позволяют находить подходящие пакеты:

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

Новый пакет подключается, только если его путь соответствует шаблону. После добавления проверьте результаты поиска и исключите сгенерированный или внутренний контент, который не нужно отправлять на перевод. Исключения по умолчанию охватывают типичные каталоги сборки, но не все каталоги, специфичные для проекта.

В старых версиях и проектах с разной структурой пути можно указать явно:

json
{
  "locale": { "source": "en", "targets": ["es", "fr"] },
  "buckets": {
    "json": {
      "include": [
        "apps/web/locales/[locale].json",
        "apps/dashboard/locales/[locale].json"
      ]
    },
    "markdown": { "include": ["packages/docs/content/[locale]/*.md"] }
  }
}

Оба варианта используют один корневой Lockfile и один сервис перевода. Не запускайте одновременно независимые процессы, которые работают с этим общим состоянием.

Как разделить пакеты с разными правилами #

Поместите i18n.json в каждый пакет, которому нужны собственные целевые языки или другой движок локализации. Явно выберите engineId. Пакеты могут использовать общий движок локализации и при этом запрашивать разные языковые пары.

Запускайте из каталога соответствующего пакета:

sh
cd apps/web
lingo run

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

Как явно задать список пакетов в CI #

В матрице можно перечислить рабочие каталоги. В каждом из них рядом с его i18n.json запускается исполняемый файл старой версии CLI с закреплённой версией. Если добавить пакет в репозиторий, он не появится в явно заданной матрице автоматически.

Рабочий процесс закрепляет версию действия Lingo.dev отдельно от lingo.dev@0.138.10. Для перевода сохраните LINGODOTDEV_API_KEY как секрет репозитория, а в настройках репозитория разрешите Actions создавать пул-реквесты. GH_TOKEN предоставляет отдельные учётные данные GitHub.

yaml
name: Translate legacy packages
on:
  workflow_dispatch:
  push:
    branches: [main]
permissions:
  contents: write
  pull-requests: write
concurrency:
  group: legacy-translations-${{ github.ref }}
  cancel-in-progress: false
jobs:
  translate:
    runs-on: ubuntu-latest
    strategy:
      max-parallel: 1
      fail-fast: false
      matrix:
        package: [apps/web, apps/marketing]
    steps:
      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
        with:
          fetch-depth: 0
      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
        with:
          node-version: "22"
      - uses: lingodotdev/lingo.dev@0050b4858e1cea2b745c8f131fe178a23f643dc7
        with:
          version: "0.138.10"
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          working-directory: ${{ matrix.package }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Для каждого пакета сохраните в репозитории собственный i18n.json, исходные файлы, принятые переводы и i18n.lock. Если используете общую корневую конфигурацию, измените матрицу на package: ["."]. Тогда рекурсивные шаблоны исходных файлов смогут находить пакеты в рамках этой конфигурации.

Действие старой версии использует одну ветку перевода для базовой ветки, поэтому задания пакетов выполняются последовательно и обновляют один пул-реквест. Группа параллельного выполнения должна быть общей с другими рабочими процессами, которые используют эту ветку перевода. Проверяйте в пул-реквесте результаты для каждого пакета, в том числе после повторных запусков. Перед слиянием запускайте проверки ресурсов каждого пакета.

Если GitHub помечает рабочие процессы пул-реквеста как ожидающие одобрения, участник с правом записи в репозиторий должен выбрать Одобрить запуск рабочих процессов. См. как работает GITHUB_TOKEN в GitHub.