Nastavte průběžnou lokalizaci pro GitHub Action, GitLab CI/CD, Bitbucket Pipelines nebo samostatné CLI. Všechny tyto možnosti spouštějí CLI od Lingo.dev ve vaší pipeline, takže nastavení vždy zahrnuje stejné tři kroky: nakonfigurovat CLI, přidat API klíč a vybrat workflow.
Chcete raději nastavit GitHub App?
GitHub App tenhle postup nepoužívá – nepotřebujete lokální CLI, i18n.json ani secret s API klíčem. Aplikaci nainstalujete jednou a do repozitáře přidáte .lingo/config.json. Místo toho se řiďte návodem pro GitHub App.
Co budete potřebovat
Než přidáte CI/CD, potřebujete funkční nastavení CLI, soubor i18n.json a možnost spustit npx lingo.dev@latest run lokálně.
Krok 1. Nakonfigurujte CLI#
Pokud ještě nemáte hotovo, projděte si návod Nastavení CLI. Na konci byste měli mít:
- Soubor
i18n.jsonv kořenovém adresáři projektu - API klíč (buď
LINGO_API_KEYpro Lingo.dev Engine, nebo klíč poskytovatele, napříkladOPENAI_API_KEY) - Možnost generovat překlady lokálně pomocí
npx lingo.dev@latest run
Krok 2. Přidejte API klíč jako CI secret#
Uložte svůj API klíč do správy secretů na vaší CI platformě:
- Přejděte do Settings > Secrets and variables > Actions
- Klikněte na New repository secret
- Název:
LINGODOTDEV_API_KEY, hodnota: váš API klíč - Klikněte na Add secret
Krok 3. Vyberte workflow a přidejte konfiguraci#
Vyberte workflow, které vašemu týmu nejlépe sedí, a pak pokračujte podle návodu pro danou platformu:
| Workflow | Nejvhodnější pro |
|---|---|
| Commit do main | Malé týmy, které chtějí bezproblémové a nenápadné aktualizace překladů |
| PR z main | Týmy, které chtějí překlady zkontrolovat, než se dostanou do main |
| Commit do feature branch | Týmy s dlouho žijícími feature branches |
| PR z feature branch | Týmy, které chtějí mít maximální kontrolu nad každou změnou v překladech |
Nevíte si rady, co vybrat? Začněte s „Commit do main“ – je to nejjednodušší možnost. Později můžete přepnout, aniž byste museli měnit svůj i18n.json.
Návody k nastavení pro jednotlivé platformy a příklady workflow najdete tady:
Ověření nastavení#
Po nastavení CI workflow pushněte změnu, která ho spustí. Integrace by měla:
- Spustit překladovou pipeline
- Commitnout překlady nebo otevřít PR (podle zvoleného workflow)
- Aktualizovat soubor
i18n.lock
Pokud chcete v CI ověřit, že jsou překlady kompletní, aniž by se generovaly nové, použijte příznak --frozen:
npx lingo.dev@latest run --frozenPokud některý obsah není přeložený, příkaz skončí s nenulovým stavovým kódem – hodí se třeba jako brána pro nasazení. Příklady najdete v části Pokročilé vzory.
