Как организовать работу с CLI v0 в монорепозитории
Выберите общую конфигурацию или отдельную для каждого пакета и сохраняйте связь каждого результата перевода в старой версии CLI с его базовой версией исходных данных.
Используйте один i18n.json в корне, если у пакетов общие исходный язык, целевые языки и сервис перевода. Для пакетов с отдельными правилами или ответственными используйте отдельные файлы. У каждой конфигурации свой i18n.lock.
Найдите общий макет в корневой конфигурации #
Рекурсивные шаблоны в 0.135.0 позволяют находить подходящие пакеты:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": { "include": ["apps/**/locales/[locale].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. Пакеты могут использовать общий движок локализации и при этом запрашивать разные языковые пары.
Запускайте из каталога соответствующего пакета:
cd apps/web
lingo runСохраняйте в одном коммите исходные файлы пакета, принятые результаты перевода, конфигурацию и Lockfile. Проверяйте сборку приложения или документации самого пакета: общие инструкции по переводу не гарантируют, что каждый пакет загружает сгенерированные файлы.
Как явно задать список пакетов в CI #
В матрице можно перечислить рабочие каталоги. В каждом из них рядом с его i18n.json запускается исполняемый файл старой версии CLI с закреплённой версией. Если добавить пакет в репозиторий, он не появится в явно заданной матрице автоматически.
Рабочий процесс закрепляет версию действия Lingo.dev отдельно от lingo.dev@0.138.10. Для перевода сохраните LINGODOTDEV_API_KEY как секрет репозитория, а в настройках репозитория разрешите Actions создавать пул-реквесты. GH_TOKEN предоставляет отдельные учётные данные GitHub.
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.