Organiser la CLI v0 dans un monorepo
Choisissez une configuration partagée ou propre à chaque paquet, et conservez le lien entre chaque sortie de l’ancienne version et son état de référence des sources.
Utilisez un seul i18n.json à la racine lorsque les paquets partagent la même langue source, les mêmes langues cibles et le même service de traduction. Utilisez des fichiers propres à chaque paquet lorsqu’ils ont besoin de règles ou d’une gestion indépendantes. Chaque configuration possède son propre i18n.lock.
Identifier une mise en page partagée à partir de la configuration racine #
Depuis 0.135.0, les motifs récursifs permettent de détecter les paquets correspondants :
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": { "include": ["apps/**/locales/[locale].json"] }
}
}Un nouveau paquet n’est pris en compte que si son chemin correspond aux motifs. Vérifiez les résultats de la détection après l’avoir ajouté et excluez le contenu généré ou interne qui ne doit pas être envoyé pour traduction. Les exclusions par défaut couvrent les répertoires de compilation courants, mais pas toutes les arborescences propres à votre projet.
Pour les anciennes versions ou les structures variées, vous pouvez indiquer les chemins explicitement :
{
"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"] }
}
}Les deux structures partagent un seul Lockfile à la racine et le même service de traduction. N’exécutez pas simultanément des processus indépendants qui utilisent cet état partagé.
Séparer les paquets soumis à des règles différentes #
Placez i18n.json dans chaque paquet qui a besoin de cibles indépendantes ou d’un moteur de localisation différent. Sélectionnez explicitement engineId. Les paquets peuvent partager un moteur de localisation tout en utilisant des paires de langues différentes.
Exécutez la commande depuis le répertoire du paquet concerné :
cd apps/web
lingo runCommittez ensemble les sources, les sorties acceptées, la configuration et le Lockfile de ce paquet. Vérifiez la compilation de son application ou de sa documentation : le partage des instructions de traduction ne garantit pas que chaque paquet charge les fichiers générés.
Définir explicitement la liste des paquets dans la CI #
Une matrice peut lister les répertoires de travail. Dans chacun d’eux, elle appelle le binaire de l’ancienne version, dont la version est fixée, à côté de son i18n.json. Ajouter un paquet au dépôt ne l’ajoute pas à une matrice explicite.
Le workflow fixe la version de l’action Lingo.dev indépendamment de lingo.dev@0.138.10. Enregistrez LINGODOTDEV_API_KEY comme secret du dépôt pour la traduction et autorisez Actions à créer des demandes de fusion dans les paramètres du dépôt. GH_TOKEN fournit l’identifiant d’authentification GitHub distinct.
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 }}Chaque paquet doit avoir ses propres i18n.json, fichiers sources, cibles acceptées et i18n.lock, tous committés. Pour utiliser une configuration partagée à la racine, remplacez la matrice par package: ["."] ; les motifs récursifs des sources peuvent alors détecter les paquets couverts par cette configuration unique.
L’ancienne action utilise une branche de traduction pour la branche de base. Les tâches des paquets sont donc exécutées en série afin de mettre à jour la même demande de fusion. Conservez un groupe de concurrence commun avec les autres workflows qui utilisent cette branche de traduction. Relisez les sorties de chaque paquet dans la demande de fusion, y compris après les réexécutions, et lancez les vérifications des ressources de chaque paquet avant la fusion.
Si GitHub indique que les workflows de la demande de fusion sont en attente d’approbation, une personne disposant d’un accès en écriture au dépôt doit sélectionner Approuver l’exécution des workflows. Consultez le comportement de GITHUB_TOKEN sur GitHub.