Lingo.dev udržuje překlady synchronizované s vaším kódem. Při každé změně rozpozná, který obsah se změnil, přeloží ho přes váš připojený lokalizační engine – s důsledně použitými pravidly glosáře, hlasem značky a konfigurací modelu pro jednotlivé jazyky – a výsledky commitne nebo otevře pull request. Neúplné překlady se do produkce nikdy nedostanou.
Vyberte si integraci#
Každá integrace má vlastní návod. Vyberte si tu, která odpovídá vašemu setupu:
| Integrace | Jak funguje |
|---|---|
| GitHub App | Stačí nainstalovat jednou. Lingo.dev za vás spouští lokalizaci při pushech do výchozí větve a po aktivaci i při pull requestech – bez runneru, bez API key secretu, bez lockfilu. |
| GitHub Actions | Nainstaluje @lingo.dev/cli a spustí lingo push ve vaší pipeline GitHub Actions, pak commitne výsledky nebo otevře PR. |
| GitLab CI/CD | Nainstaluje @lingo.dev/cli a spustí lingo push v jobu pipeline GitLab. |
| Bitbucket Pipelines | Nainstaluje @lingo.dev/cli a spustí lingo push v kroku pipeline Bitbucket. |
GitHub App běží na serverech Lingo.dev. Všechny ostatní integrace spouštějí Lingo.dev CLI, takže lokalizaci můžete spouštět přímo v libovolném CI/CD prostředí s Node.js 22+, i bez nativní integrace.
Jak funguje GitHub App#
Aplikaci stačí nainstalovat jednou a do repozitáře přidat .lingo/config.json. Od té chvíle za vás Lingo.dev spouští lokalizaci – bez pipeline, bez API key secretu, bez lockfilu:
- Sleduje změny – hned po instalaci reaguje na push do výchozí větve a po aktivaci
onPullRequesttaké na pull requesty; změněné soubory kontroluje podle vámi nastavených source patterns - Překládá jen delta změny – posílá změněný zdrojový obsah přes engine určený v
engineId - Zapisuje výsledky zpět do GitHubu – při pushech do výchozí větve otevře nebo aktualizuje pull request s překlady; u pull requestů commitne přeložené soubory do PR větve a přidá stavový komentář
- Dohledá a dávkuje změny – rozpozná změny, které předchozí běh nezachytil, a velmi rozsáhlé aktualizace rozdělí do více commitů
Běhy můžete podmínit schválením nebo překlady spouštět ručně pomocí příkazů /lingo v pull requestu. Kompletní konfiguraci najdete v návodu pro GitHub App.
Jak fungují integrace CLI#
Integrace pro GitHub Actions, GitLab CI/CD a Bitbucket spouštějí stejné Lingo.dev CLI jako krok ve vaší stávající pipeline. Potřebují dvě věci: konfiguraci .lingo/config.json a LINGO_API_KEY pro ověření.
Při každém spuštění job nainstaluje CLI (npm install -g @lingo.dev/cli) a spustí lingo push, které:
- Najde zdrojové soubory – načte vaši bucket configuration a vyhledá obsah k překladu
- Detekuje změny – porovná
.lingo/lock.jsonlockfile a identifikuje nové nebo upravené řetězce, takže se překládá jen delta - Překládá – posílá změněný obsah přes váš nakonfigurovaný lokalizační engine se všemi použitými pravidly – glosářem, hlasem značky a nastavením modelu pro jednotlivé jazyky
- Zapisuje výsledky – průběžně aktualizuje soubory cílového jazyka a obnovuje
.lingo/lock.json
Vaše pipeline pak výsledky commitne nebo otevře pull request pomocí nástrojů vaší platformy. Protože se překládají jen změněné řetězce, běhy jsou rychlé a nákladově efektivní – i napříč desítkami jazyků.
Možnosti workflow#
GitHub App#
Chování aplikace se konfiguruje v .lingo/config.json:
| Možnost | Co dělá |
|---|---|
Push do výchozí větve (onPushToDefaultBranch) | Ve výchozím nastavení aktivní. Otevře nebo aktualizuje PR s překlady, když se změny ve zdrojích dostanou do výchozí větve. |
Překlad pull requestu (onPullRequest) | Ve výchozím nastavení neaktivní. Jak se PR mění, commituje překlady do PR větve. |
Schvalovací brána (requireApproval) | Ve výchozím nastavení neaktivní. Vyžaduje Approve/Deny v check runu nebo /lingo approve v PR, než automatické běhy začnou překládat. |
Ruční příkazy (/lingo translate) | Kdykoli doplní chybějící překlady nebo vynutí překlad konkrétních souborů z komentáře v PR. |
Kompletní konfiguraci a přehled příkazů najdete v návodu pro GitHub App.
CLI v CI/CD (GitHub Actions, GitLab CI, Bitbucket)#
Čtyři workflow pokrývají většinu týmových setupů:
| Workflow | Spouštěč | Výstup |
|---|---|---|
| Commit do main | Push do main | Překlady se commitují přímo do main |
| PR z main | Push do main | Pull request s překlady |
| Commit do feature větve | Push do feature větve | Překlady se commitují do větve |
| PR z feature větve | Push do feature větve | Pull request z větve |
První možnost – commit do main – je nejjednodušší. Překlady se objeví automaticky bez jakéhokoli zásahu vývojáře. Varianty založené na PR přidávají krok kontroly, než se překlady dostanou dál.
Podrobnosti k výběru mezi těmito možnostmi najdete v Advanced Patterns.
