Integrace

Propojte překlady v repozitářích a CMS, spouštějte lokalizaci v CI, sbírejte podklady ze služby Crowdin nebo prošetřujte zpětnou vazbu ze služby Jira.

Používejte Lingo.dev spolu s nástroji, ve kterých váš tým tvoří, překládá a kontroluje obsah. Každé připojení má svůj účel. Některá vracejí přeložený obsah do zdrojového systému, jiná shromažďují podklady nebo pomáhají prošetřovat zpětnou vazbu.

Překládejte obsah přímo v jeho stávajícím systému #

Tato nativní připojení načítají vybraný zdrojový obsah, překládají ho pomocí lokalizačního engine a zapisují výsledek zpět s oprávněními, která u poskytovatele udělíte.

PřipojeníCo spouští zpracováníKam se překlady vracejí
GitHubNastavené události v repozitáři nebo příkaz k překladu s vymezeným rozsahemDo pull requestu s překlady změn ve výchozí větvi nebo jako commity do větve pull requestu, který splňuje podmínky.
PayloadRuční synchronizace nebo notifikace pluginu o změnách zdrojového obsahuDo lokalizovaných polí ve stejných kolekcích a globálních položkách, pod vybranými cílovými jazyky.
WordPressRuční synchronizace nebo uložení publikovaného obsahu, o kterém informuje pluginPropojený překlad každého příspěvku ve vybraných jazycích v Polylangu nebo WPML.
Centrum nápovědy ZendeskRuční synchronizaceDo jazykových verzí vybraných kategorií, sekcí a článků.

Nastavení poskytovatele určuje rozsah přístupu. U GitHubu vyberte repozitáře a vzory pro výběr zdrojových souborů. U Payloadu vyberte kolekce a globální položky s lokalizovanými poli. U WordPressu vyberte typy příspěvků. U Zendesku vybírejte kategorie, sekce a články samostatně: výběrem kategorie se nevyberou její podřízené položky.

Způsob publikování závisí také na poskytovateli. Režim Publikovat v Payload nezapisuje do publikovaného dokumentu, který obsahuje nepublikované úpravy, dokud tyto úpravy nepublikujete nebo nevrátíte zpět. Publikováním překladu by se totiž zveřejnily i tyto úpravy. V Zendesk může zápis konceptu odstranit již zveřejněnou jazykovou verzi, dokud ji znovu nepublikujete. Před prvním zápisem si přečtěte část o publikování u daného poskytovatele, zvlášť pokud už překlady existují.

Spouštějte překlady ve své pipeline #

GitHub Actions, GitLab CI, Bitbucket Pipelines a Buildkite spouštějí CLI na vašem vlastním runneru. Ukázkové konfigurace nejprve pracují s artefakty ke stažení nebo s jedinou důvěryhodnou větví, takže si můžete výsledek zkontrolovat, než rozšíříte oprávnění k zápisu do repozitáře. Jakmile je .lingo/lock.json součástí commitu, příkaz lingo check označí kontrolu pull requestu nebo merge requestu jako neúspěšnou, pokud se zdroj od posledního překladu změnil nebo chybí cílový soubor. Žádný klíč API k tomu nepotřebuje.

Vaše pipeline zajišťuje plánování, správu tajných údajů, uchovávání výstupů a vytváření commitů nebo pull requestů. Klíč API Lingo.dev opravňuje k překladu; přihlašovací údaje poskytovatele opravňují k zápisu do repozitáře. Část Automatizace překladů v CI vysvětluje, jak udržet revize zdrojového obsahu, hotové výstupy a kontroly aplikace pohromadě.

Měřte překlady nebo prošetřujte zpětnou vazbu #

Crowdin odesílá do nástroje Radar podporované aktivity na úrovni jednotlivých řetězců. Můžete tak zkoumat překlady vytvořené ve službě Crowdin, aniž byste přesouvali workflow jejich vytváření nebo kontroly. Nastavte měření podle otázky, na kterou hledáte odpověď, a poté si prohlédněte shromážděný text a výsledek měření. Toto připojení nesynchronizuje opravené překlady zpět do služby Crowdin.

Jira vychází z nahlášeného problému. Přidáním štítku lingo požádáte workflow Triage, aby problém prozkoumalo a navrhlo změny glosáře, pravidel nebo hlasu značky. Lidé každý návrh uplatní nebo zamítnou a poté rozhodnou, zda dotčený obsah z připojených systémů přeložit znovu. Triage ve službě Jira nepřekládá obsah tiketu jako lokalizační projekt.

Než rozšíříte rozsah, dokončete první spuštění #

Stránka každého poskytovatele vás provede prvním spuštěním v malém rozsahu: od autorizace a konfigurace přes kontrolu výstupu až po obnovu. Během tohoto spuštění si ověřte, co připojení načítá a mění. Dostupnost připojení může záviset na oprávněních v organizaci a přístupu k funkcím; samotné přihlašovací údaje poskytovatele nezajišťují přístup k lokalizačnímu engine.

Při vyřazování připojení zabraňte novým spuštěním a přihlašovací údaje poskytovatele řešte samostatně. Odpojení nevrátí zpět dodaný obsah, zveřejněné komentáře ani zaznamenaná měření. Část o obnově u daného poskytovatele vysvětluje, jaký stav zůstane zachován a co se stane při opětovném připojení.

Pokud workflow řídí vaše aplikace, pokračujte do části DevTools, kde najdete informace o API, CLI a rozhraních pro JavaScript.