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 | Spouští CLI ve vaší GitHub Actions pipeline přes oficiální Action. |
| GitLab CI/CD | Spouští CLI v GitLab pipeline přes oficiální Docker image. |
| Bitbucket Pipelines | Spouští CLI v Bitbucket pipeline přes oficiální Pipe. |
Kromě GitHub App běží v každé integraci Lingo.dev CLI – takže lokalizaci můžete spouštět přímo v jakémkoli CI/CD prostředí s Node.js, 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 v pipeline#
GitHub Action, GitLab CI/CD, Bitbucket Pipelines i samostatné CLI používají stejný Lingo.dev CLI jako krok ve vaší stávající pipeline. Potřebují dvě věci: konfiguraci i18n.json a API klíč.
Při každém spuštění integrace:
- Najde zdrojové soubory – načte vaši bucket configuration a vyhledá obsah k překladu
- Rozpozná změny – porovná stav se souborem
i18n.locka určí 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 – aktualizuje soubory cílového jazyka přímo na místě
- Commitne změny nebo otevře PR – podle zvoleného workflow
Protože se překládají jen změněné řetězce, jsou běhy 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.
GitHub Action, GitLab CI, Bitbucket a CLI#
Č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.
