Centrum nápovědy Zendesk
Překládejte kategorie, sekce a články Centra nápovědy do jejich stávajících jazykových verzí a mějte synchronizaci i publikování pod ruční kontrolou.
Překládejte obsah Centra nápovědy přímo v Zendesk. Připojení Lingo.dev načte vybrané kategorie, sekce a články ve výchozím jazyce Centra nápovědy, přeloží je pomocí lokalizačního engine a zapíše verze v cílových jazycích do týchž položek.
V navigaci Studio 2.5 přejděte na Studio 2.5 → Integrace místo Nastavení → Integrace. Stávající odkazy pro připojení a nastavení fungují i nadále.
Překlady se spouštějí ručně. Po změně článku spusťte synchronizaci obsahu, který chcete aktualizovat. Před prvním zápisem zvolte, zda se mají překlady ukládat jako koncepty, nebo rovnou publikovat: pokud již publikovanou cílovou verzi zapíšete jako koncept, může být pro čtenáře nedostupná až do opětovného publikování.
Připravte přístup a nastavte jazyky Centra nápovědy #
Integrace Centra nápovědy Zendesk vyžaduje plán Enterprise. Aktuální dostupnost najdete v ceníku. Pokud organizace nemá potřebný plán, v části Nastavení → Integrace se u Zendesk zobrazí Není dostupné ve vašem plánu.
Použijte účet správce Zendesk s přístupem k obsahu Centra nápovědy. Oprávnění správce jsou nutná k registraci webhooku pro publikování článků, který shromažďuje aktivitu pro Radar. Zápisy se připisují účtu, který přístup autorizoval. Pokud je tým potřebuje připisovat společnému účtu, použijte vhodný servisní účet. V Lingo.dev potřebujete oprávnění i nárok organizace na připojení a také přístup k vybranému lokalizačnímu engine.
Povolte cílové jazyky v nastavení jazyků Centra nápovědy. Seznam lokalizací platný pro celý účet Zendesk je samostatný a překlady Centra nápovědy nepovoluje. S příslušnou autorizací můžete konfiguraci jazyků Centra nápovědy zobrazit prostřednictvím koncového bodu https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, který slouží pouze ke čtení.
Lingo.dev při každém spuštění načte výchozí jazyk Centra nápovědy a použije ho jako zdrojový. Ve formuláři připojení jiný zdrojový jazyk nevybíráte.
Vytvořte připojení a přeložte první článek #
- Otevřete Nastavení → Integrace a u Zendesk vyberte Připojit. Zadejte název a subdoménu Centra nápovědy. Pro
acme.zendesk.comzadejteacme. - Pokračujte do Zendesk a autorizujte přístup. Připojení se vytvoří až po úspěšné autorizaci.
- V rozhraní Studio vyberte Centrum nápovědy v části Připojené a poté zvolte Nastavit.
- Vyberte lokalizační engine a režim zpětného zápisu a poté zvolte Pokračovat. Pro první spuštění vyberte jeden cílový jazyk z těch, které jsou v Centru nápovědy povolené. Zdrojový jazyk se do výběru nezahrnuje. Pokud není dostupný žádný jiný jazyk, nejprve ho v Zendesk povolte.
- Otevřete Články a u jednoho článku s ustáleným zdrojovým textem zapněte přepínač Synchronizace. Počkejte, až se nastavení uloží, zaškrtněte políčko v řádku článku a zvolte Zařadit synchronizaci do fronty.
- Zkontrolujte výsledek workflow i samotný cílový článek v Zendesk. Ověřte jeho název, obsah, odkazy, jazyk a to, zda je konceptem, nebo publikovanou verzí. Pokud má být publikovaný, otevřete také jeho URL určenou čtenářům.
První synchronizace převezme úplné existující překlady, aniž by je přepsala. Zachová jejich text i stav konceptu a přeloží chybějící obsah. Pokud chcete existující překlad záměrně nahradit, použijte možnost Přeložit znovu.
Vyberte celou oblast, kterou chcete přeložit #
Kategorie, sekce a články mají samostatné tabulky a přepínače Synchronizace, jejichž nastavení se ukládá. Zapnutím synchronizace u kategorie se přeloží její název a popis, ale synchronizace jejích sekcí ani článků se tím nezapne. Pokud připravujete celou oblast Centra nápovědy, vyberte je zvlášť.
| Položka | Překládaná pole |
|---|---|
| Kategorie | Název/titulek a popis |
| Sekce | Název/titulek a popis |
| Článek | Název a obsah |
Zaškrtávací políčka v řádcích omezují jednorázové akce Zařadit synchronizaci do fronty a Zařadit opětovný překlad do fronty na vybrané položky, které už mají zapnutý přepínač Synchronizace. Zaškrtnutím řádku se tento přepínač nezapne. Akce v záhlaví zahrnují všechny položky připojení se zapnutou synchronizací. Před spuštěním ověřte, který výběr akce zpracuje.
Obsah článků se zpracovává jako HTML, aby se obnovilo formátování, odkazy a vložená média. Při zpětném zápisu lze rozpoznané odkazy Centra nápovědy přizpůsobit cílovému jazyku. Ve výsledku tyto odkazy zkontrolujte a ověřte i to, zda přeložená cílová stránka existuje. Externí odkazy a navigaci specifickou pro daný web je nadále nutné kontrolovat samostatně.
Toto připojení nepřekládá tikety, makra, motivy, komunitní příspěvky ani články založené na blocích obsahu Zendesk. Slouží k lokalizaci obsahu Centra nápovědy, nikoli k procesu Triage u tiketů podpory.
Aktualizujte změněný obsah nebo ho nahraďte #
Synchronizace porovnává aktuální zdroj se zaznamenaným stavem a existujícími překlady. Používejte ji pro běžné aktualizace zdroje, doplnění chybějícího obsahu a dokončení práce z předchozího spuštění.
Přeložit znovu znovu vygeneruje vybrané položky v příslušných jazycích, i když se zdrojový text nezměnil. Může přepsat schválené ruční úpravy. Hromadná akce v záhlaví vyžaduje potvrzení. Také u akcí pro vybrané řádky je nutné zvolit, v jakém rozsahu chcete překlady nahradit.
V rámci jednoho připojení může být současně aktivní jen jedno spuštění. Další požadavky se řadí do fronty. Pokud je fronta plná, je třeba počkat na uvolnění kapacity. Výsledky najdete v části Spuštění workflow. Možnost Zastavit zruší práci, kterou ještě lze zastavit. Výsledek označený jako aktuální znamená, že žádná vybraná změna nevyžadovala zpracování, nikoli že byla znovu posouzena kvalita překladu.
Ověřte, co čtenáři vidí #
Režim Publikovat zapisuje překlady jako publikované verze. Režim Koncept zapisuje nepublikované jazykové verze ke kontrole v Zendesk. Pokud v režimu Koncept aktualizujete již publikovanou jazykovou verzi, nový koncept ji může čtenářům znepřístupnit, dokud ji někdo znovu nepublikuje. Před zahájením aktualizace zvažte, zda je takové přerušení dostupnosti slučitelné s plánem vydání.
Po zápisu zkontrolujte cílovou URL v požadovaném jazyce. Porovnejte skutečný název a obsah s příslušnou revizí zdroje, projděte odkazy a hledejte případné zbytky textu ve zdrojovém jazyce. Dokončený překlad je jen jednou částí vydání. Schválení a publikování zůstávají na redakci.
Zpracujte změny zdroje a částečné výsledky #
Při zpětném zápisu se zdrojová položka znovu načte. Pokud se po naplánování změnila nebo byla odstraněna, Lingo.dev cílovou verzi přeskočí. Až bude zdroj připravený, spusťte další ruční synchronizaci, která zohlední nový stav.
Selhání u jednoho jazyka nevrátí zpět úspěšné zápisy v ostatních jazycích. Zkontrolujte zapsané, přeskočené a neúspěšné položky a poté opakujte pokus jen v dotčeném rozsahu. Vynucené zpracování celého Centra nápovědy může přepsat již schválený text, aniž by odstranilo původní příčinu.
Pokud výstup chybí, zkontrolujte výběr položek, povolené jazyky Centra nápovědy, přístup k lokalizačnímu engine, režim zpětného zápisu, vyloučení obsahu založeného na blocích a případné změny zdroje. Při převzetí úplného existujícího překladu se nový text záměrně nevytváří. Pokud byl cílový jazyk v Zendesk zakázán, při spuštění se přeskočí. Aktualizujte proto výběr cílových jazyků připojení.
Při dočasném výpadku Zendesk opakujte pokus po obnovení služby. Pokud potřebujete obnovit autorizaci, použijte u stávajícího připojení možnost Znovu připojit. Odpojením a vytvořením nového připojení se stav synchronizace ztratí.
Odpojte se nebo se znovu připojte #
Cílové jazyky, lokalizační engine a režim změníte na kartě Nastavení Centra nápovědy v rozhraní Studio. Účet přejmenujete nebo znovu připojíte v části Nastavení → Integrace. Možností Znovu připojit obnovíte autorizaci stávajícího připojení.
Odpojení zastaví čtení i zápis a odstraní lokální připojení, historii spuštění i záznamy o synchronizaci jednotlivých položek. Existující překlady v Zendesk zůstanou zachované. Pokud poté vytvoříte nové připojení, nastaví se nový výchozí stav: první synchronizace zachová úplné překlady, které už existují, a doplní chybějící obsah. Pokud má přístup skončit, odvolejte samostatně také autorizaci u poskytovatele. Dříve publikované znění v případě potřeby obnovte přímo v Zendesk.
Shromažďujte aktivitu v nástroji Radar #
Připojení také předává aktivitu Centra nápovědy nástroji Radar. Dokument Shromažďování překladů pro měření popisuje nastavení událostí i to, jak importovat historii poskytovatele před spuštěním měření historických dat.
Pokud ruční překlad funguje, ale nová aktivita článků chybí, zkontrolujte registraci webhooku připojení a doručování událostí. Autorizace může proběhnout úspěšně, i když účet bez oprávnění správce nedokáže webhook zaregistrovat. V části Nastavení → Integrace použijte u stávajícího připojení Zendesk možnost Znovu připojit a autorizujte přístup jako správce. Než se spolehnete na automatické shromažďování, publikujte testovací článek a ověřte jeho událost v nástroji Radar.