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:

json
{
  "$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:

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"] }
  }
}

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:

sh
cd apps/web
lingo run

Zdrojové 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.

yaml
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.