CLI v0 in einem Monorepo organisieren
Wähle eine gemeinsame Konfiguration oder eine Konfiguration pro Paket und halte jede Ausgabe der älteren Version mit ihrem jeweiligen Ausgangsstand der Quelldaten verknüpft.
Verwende eine gemeinsame i18n.json im Stammverzeichnis, wenn die Pakete dieselbe Quellsprache, dieselben Zielsprachen und dasselbe Übersetzungs-Backend nutzen. Verwende separate Dateien pro Paket, wenn sie eigene Vorgaben oder Zuständigkeiten benötigen. Jede Konfiguration hat ihre eigene i18n.lock.
Ein gemeinsames Layout anhand der Stammkonfiguration ermitteln #
Ausgehend von 0.135.0 lassen sich mit rekursiven Mustern passende Pakete finden:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": { "include": ["apps/**/locales/[locale].json"] }
}
}Ein neues Paket wird nur einbezogen, wenn sein Pfad zum Muster passt. Sieh dir nach dem Hinzufügen an, welche Pakete erkannt werden, und schließe generierte oder interne Inhalte aus, die nicht zur Übersetzung gesendet werden sollen. Die standardmäßigen Ausschlüsse decken gängige Build-Verzeichnisse ab, aber nicht jede projektspezifische Verzeichnisstruktur.
Bei älteren Versionen und unterschiedlichen Verzeichnisstrukturen lassen sich Pfade explizit auflisten:
{
"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"] }
}
}Beide Strukturen nutzen ein gemeinsames Lockfile im Stammverzeichnis und dasselbe Backend. Führe keine unabhängigen Prozesse gleichzeitig aus, die auf diesen gemeinsamen Zustand zugreifen.
Pakete mit unterschiedlichen Vorgaben trennen #
Lege i18n.json in jedem Paket ab, das eigene Zielsprachen oder eine andere Lokalisierungs-Engine benötigt. Wähle engineId explizit aus. Pakete können dieselbe Lokalisierungs-Engine nutzen und dennoch unterschiedliche Sprachpaare anfordern.
Führe den Befehl im Verzeichnis des jeweiligen Pakets aus:
cd apps/web
lingo runErstelle einen gemeinsamen Commit mit den Quelldateien, der akzeptierten Ausgabe, der Konfiguration und dem Lockfile des Pakets. Kontrolliere den Anwendungs- oder Dokumentations-Build des jeweiligen Pakets: Gemeinsame Übersetzungsanweisungen stellen nicht sicher, dass jedes Paket die generierten Dateien lädt.
Die Paketliste in CI explizit führen #
Eine Matrix kann die Arbeitsverzeichnisse auflisten. In jedem davon wird die Binärdatei der älteren CLI in der festgelegten Version neben der zugehörigen i18n.json aufgerufen. Ein neues Paket im Repository wird nicht automatisch in eine explizite Matrix aufgenommen.
Der Workflow legt die Version der Lingo.dev Action unabhängig von lingo.dev@0.138.10 fest. Speichere LINGODOTDEV_API_KEY als Repository-Geheimnis für die Übersetzung und erlaube Actions in den Repository-Einstellungen, Pull Requests zu erstellen. GH_TOKEN stellt die separaten GitHub-Zugangsdaten bereit.
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 }}Für jedes Paket müssen eine eigene i18n.json, die Quelldateien, die akzeptierten Zieldateien und i18n.lock im Repository committed sein. Ändere die Matrix für eine gemeinsame Konfiguration im Stammverzeichnis auf package: ["."]; rekursive Quellmuster können dann Pakete innerhalb dieser einen Konfiguration erkennen.
Die ältere Action verwendet einen Übersetzungs-Branch für den Basis-Branch. Deshalb werden die Paket-Jobs nacheinander ausgeführt, um denselben Pull Request zu aktualisieren. Nutze dieselbe Parallelitätsgruppe auch für andere Workflows, die diesen Übersetzungs-Branch verwenden. Führe im PR eine Prüfung der Ausgabe jedes Pakets durch, auch nach erneuten Ausführungen, und führe vor dem Merge die Ressourcenprüfungen jedes Pakets aus.
Wenn GitHub anzeigt, dass die PR-Workflows auf Genehmigung warten, muss jemand mit Schreibzugriff auf das Repository Workflows zur Ausführung genehmigen auswählen. Siehe GitHubs Verhalten bei GITHUB_TOKEN.