Nastavte Průběžná lokalizace na GitHubu, GitLabu nebo Bitbucketu. K dispozici jsou dvě podporované cesty: spravovaná Lingo.dev GitHub App a spuštění @lingo.dev/cli ve vlastní pipeline. Vyberte si tu, která odpovídá vaší platformě i tomu, jak velkou kontrolu chcete mít.
Kterou variantu zvolit?#
| Varianta | Nejvhodnější pro | Co potřebujete |
|---|---|---|
| GitHub App | Repozitáře hostované na GitHubu | Nainstalujte aplikaci a potom commitněte .lingo/config.json s engineId. Není potřeba runner, secret ani CLI. |
@lingo.dev/cli v runneru | GitLab, Bitbucket nebo GitHub Actions, pokud chcete plnou kontrolu | Node 22+, @lingo.dev/cli, secret LINGO_API_KEY a job, který spouští lingo push. |
Používáte GitHub? Začněte s GitHub App
GitHub App běží na serveru. Čte commitnutý soubor .lingo/config.json (včetně vašeho engineId), reaguje na push i pull requesty a nevyžaduje runner, secret s API klíčem ani lock file. Stačí postupovat podle průvodce pro GitHub App a máte hotovo — zbytek této stránky se věnuje spuštění CLI ve vlastní pipeline.
Spuštění CLI ve vlastní pipeline#
Pokud používáte GitLab nebo Bitbucket, nebo chcete lokalizaci na GitHubu řídit sami, spouštějte @lingo.dev/cli jako job ve své pipeline. Nastavení je na všech platformách stejné a má tři kroky: nakonfigurovat CLI, přidat API klíč a zvolit workflow.
Co budete potřebovat
Než ho přidáte do CI, potřebujete funkční nastavení CLI se souborem .lingo/config.json a možnost spouštět lingo push lokálně.
Krok 1. Nakonfigurujte CLI#
Pokud ještě nemáte hotovo, projděte si CLI Quickstart. Na konci byste měli mít:
- Soubor
.lingo/config.jsonv kořeni projektu (viz Konfigurace) LINGO_API_KEYpro Lingo.dev engine- Možnost generovat překlady lokálně pomocí
lingo push
CLI běží na Node 22+. Ve své pipeline ho nainstalujete takto:
npm install -g @lingo.dev/cliKrok 2. Přidejte API klíč jako CI secret#
lingo push se ověřuje pomocí proměnné prostředí LINGO_API_KEY. Uložte ji do správy secretů své CI platformy:
- Přejděte do Settings > Secrets and variables > Actions
- Klikněte na New repository secret
- Název:
LINGO_API_KEY, hodnota: váš API klíč - Klikněte na Add secret
Krok 3. Vyberte workflow a přidejte konfiguraci#
Váš job spouští lingo push, aby vygeneroval překlady, a pak výsledek commitne nebo otevře pull request pomocí nástrojů vaší platformy. Vyberte si workflow, které vašemu týmu sedí nejlépe:
| 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 .lingo/config.json.
Návody k nastavení pro jednotlivé platformy a příklady workflow najdete tady:
Ověření nastavení#
Jakmile CI job nakonfigurujete, proveďte push změny, která ho spustí. Pipeline by měla:
- Spustit
lingo pusha přeložit nový i upravený obsah - Commitnout překlady nebo otevřít PR (podle zvoleného workflow)
- Aktualizovat soubor
.lingo/lock.json, který sleduje, co už bylo přeloženo
Pokud chcete v CI ověřit, že jsou překlady kompletní, aniž by se generovaly nové, spusťte lingo check:
lingo checkPokud 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.
