Organizar a CLI v0 num monorepo
Escolha uma configuração partilhada ou por pacote e mantenha cada resultado da versão antiga associado à respetiva versão de referência da origem.
Utilize um único i18n.json na raiz quando os pacotes partilharem o idioma de origem, os idiomas de destino e o serviço de tradução. Utilize ficheiros por pacote quando forem necessárias políticas ou responsabilidades de gestão independentes. Cada configuração tem o seu próprio i18n.lock.
Descobrir uma disposição partilhada a partir da configuração raiz #
A partir de 0.135.0, os padrões recursivos permitem descobrir os pacotes correspondentes:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": { "include": ["apps/**/locales/[locale].json"] }
}
}Um novo pacote só é incluído se o respetivo caminho corresponder ao padrão. Depois de o adicionar, verifique os resultados da descoberta e exclua conteúdo gerado ou interno que não deva ser enviado para tradução. As exclusões predefinidas abrangem diretórios de compilação comuns, mas não todas as árvores de diretórios específicas de cada projeto.
Em versões mais antigas ou com estruturas diferentes, os caminhos podem ser listados explicitamente:
{
"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"] }
}
}Ambas as estruturas partilham um único Lockfile na raiz e a mesma escolha de serviço de tradução. Não execute processos independentes em simultâneo sobre esse estado partilhado.
Separar pacotes com políticas diferentes #
Coloque i18n.json em cada pacote que precise de idiomas de destino independentes ou de um motor de localização diferente. Selecione engineId explicitamente. Os pacotes podem partilhar um motor de localização e, ainda assim, solicitar pares de idiomas diferentes.
Execute a partir do diretório do respetivo pacote:
cd apps/web
lingo runInclua no mesmo commit os ficheiros de origem, os resultados aceites, a configuração e o Lockfile desse pacote. Verifique a compilação da aplicação ou da documentação do próprio pacote; as instruções de tradução partilhadas não garantem que cada pacote carregue os ficheiros gerados.
Manter explícita a lista de pacotes de CI #
Uma matriz pode listar os diretórios de trabalho e executar, em cada um, o binário da versão antiga fixada, junto do respetivo i18n.json. Adicionar um pacote ao repositório não o adiciona a uma matriz explícita.
O workflow fixa a versão da Lingo.dev Action separadamente da de lingo.dev@0.138.10. Guarde LINGODOTDEV_API_KEY como segredo do repositório para a tradução e, nas definições do repositório, permita que o Actions crie pull requests. GH_TOKEN fornece a credencial separada do 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 }}Cada pacote precisa do seu próprio i18n.json, dos ficheiros de origem, dos ficheiros de destino aceites e de i18n.lock, todos guardados no repositório. Para utilizar uma configuração partilhada na raiz, altere a matriz para package: ["."]; os padrões recursivos dos ficheiros de origem poderão então descobrir pacotes abrangidos por essa única configuração.
A ação da versão antiga utiliza um ramo de tradução para o ramo de base, pelo que as tarefas dos pacotes são executadas em série para atualizar o mesmo pull request. Partilhe o grupo de concorrência com os outros workflows que utilizem esse ramo de tradução. Reveja os resultados de todos os pacotes no PR, incluindo após novas execuções, e execute as verificações de recursos de cada pacote antes de integrar as alterações.
Se o GitHub indicar que os workflows do PR aguardam aprovação, uma pessoa com permissões de escrita no repositório tem de selecionar Aprovar a execução dos workflows. Consulte o comportamento do GITHUB_TOKEN no GitHub.