Jak uspořádat CLI v0 v monorepozitáři
Zvolte sdílenou konfiguraci nebo samostatnou konfiguraci pro každý balíček a zachovejte vazbu každého výstupu starší verze na odpovídající výchozí stav zdroje.
Pokud balíčky sdílejí zdrojový jazyk, cílové jazyky a překladový backend, použijte jeden soubor i18n.json v kořenovém adresáři. Pokud potřebují samostatná pravidla nebo mají různé správce, použijte soubory pro jednotlivé balíčky. Každá konfigurace má vlastní i18n.lock.
Vyhledejte sdílené rozvržení podle kořenové konfigurace #
Pomocí rekurzivních vzorů v 0.135.0 můžete vyhledat odpovídající balíčky:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": { "include": ["apps/**/locales/[locale].json"] }
}
}Nový balíček se zahrne pouze tehdy, když jeho cesta odpovídá vzoru. Po jeho přidání zkontrolujte výsledky vyhledávání a vylučte generovaný nebo interní obsah, který se nemá odesílat k překladu. Výchozí výjimky pokrývají běžné adresáře sestavení, ne však všechny adresářové struktury specifické pro váš projekt.
U starších verzí a různých adresářových struktur můžete cesty uvést přímo:
{
"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"] }
}
}Obě uspořádání sdílejí jeden kořenový soubor Lockfile a stejnou volbu backendu. Nad tímto sdíleným stavem nespouštějte nezávislé procesy současně.
Oddělte balíčky s různými pravidly #
Umístěte i18n.json do každého balíčku, který potřebuje vlastní cílové jazyky nebo jiný lokalizační engine. Výslovně vyberte engineId. Balíčky mohou sdílet lokalizační engine a přitom požadovat různé jazykové páry.
Spouštějte z adresáře příslušného balíčku:
cd apps/web
lingo runZdrojové soubory balíčku, přijatý výstup, konfiguraci a soubor Lockfile uložte společně do jednoho commitu. Ověřte sestavení aplikace nebo dokumentace daného balíčku; sdílené překladové instrukce nezaručují, že každý balíček načítá vygenerované soubory.
Seznam balíčků v CI uvádějte výslovně #
V matici můžete vyjmenovat pracovní adresáře. V každém z nich se vedle příslušného i18n.json spustí binární soubor starší řady s pevně určenou verzí. Přidáním balíčku do repozitáře se tento výslovně zadaný seznam automaticky nerozšíří.
Workflow používá pevně určenou verzi akce Lingo.dev nezávisle na lingo.dev@0.138.10. Uložte LINGODOTDEV_API_KEY jako tajný údaj repozitáře pro překlad a v nastavení repozitáře povolte službě Actions vytvářet pull requesty. GH_TOKEN poskytuje samostatný přihlašovací údaj pro 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 }}Každý balíček potřebuje vlastní i18n.json, zdrojové soubory, přijaté cílové překlady a i18n.lock uložené v repozitáři. Pokud používáte sdílenou kořenovou konfiguraci, změňte matici na package: ["."]; rekurzivní vzory zdrojových cest pak mohou vyhledávat balíčky v rámci této jediné konfigurace.
Starší verze akce používá pro danou základní větev společnou překladovou větev, takže úlohy jednotlivých balíčků běží postupně a aktualizují tentýž pull request. Stejnou skupinu souběžného zpracování používejte i v ostatních workflow, která pracují s touto překladovou větví. V PR zkontrolujte výstup každého balíčku, a to i po opakovaném spuštění, a před sloučením spusťte u každého balíčku kontroly prostředků.
Pokud GitHub označí workflow v PR jako čekající na schválení, musí uživatel s právem zápisu do repozitáře zvolit Schválit spuštění workflow. Viz chování GITHUB_TOKEN na GitHubu.