Proč existuje
Platforma potřebuje doručovat obsah ve více jazycích bez duplikování nebo forkování základního modelu obsahu. Podpora překladu vytváří jazykové varianty na úrovni dokumentů spojené s jejich zdrojovými dokumenty při zachování původního schématu a struktury obsahu.
Použijte, když
- překládáte jednu nebo více komponent do více jazyků
- sledujete průběh hromadné překladové úlohy
- opakujete neúspěšné překlady
- ručně opravujete strojově generované překlady
- čtete přeložený obsah v dokumentační nebo webové aplikaci
- vytváříte jazykově specifické pohledy na dokumenty v CMS
Co obsahuje
- hromadný výběr komponent a jazyků v CMS
- asynchronní překladové úlohy se sledováním průběhu
- překlad dokumentů s podporou TensorZero
- automatické přeskočení překladů, které jsou již aktuální
- deduplikace totožných aktivních překladových úloh
- obnovení průběhu aktivní úlohy po navigaci v CMS
- ovládací prvky pro opětovné spuštění neúspěšných překladů
- trvalé preference cílových jazyků
- ruční oprava překladu prostřednictvím koncového bodu patch
- jazykově citlivé získávání dokumentů
- hash hodnoty zdrojů pro detekci zastaralých překladů
- databázové sloupce a indexy zohledňující překlady
Základní pracovní postup
- Otevřete stránku Komponenty a vyberte Odeslat k překladu.
- Vyberte jednu nebo více komponent a cílové jazyky.
- Zkontrolujte odhadovaný počet překladů a zařaďte dávku do fronty.
- Správce překladů načte publikované zdrojové dokumenty a přeskočí překlady, jejichž hash zdroje je již aktuální.
- Zbývající překlady jsou zpracovány asynchronně prostřednictvím TensorZero.
- Monitorujte překlady ve frontě, dokončené, přeskočené a neúspěšné přímo v CMS.
- V případě potřeby znovu spusťte neúspěšné překlady.
- Ručně opravte přeložený obsah, když je třeba upravit strojově generovaný výstup.
- Čtěte přeložené varianty prostřednictvím jazykově uvědomělých schémat a dokumentových rozhraní API.
Překladové úlohy
Odeslání dávky vytvoří překladovou úlohu. Úloha zaznamenává:
- vybrané komponenty a jazyky
- zpracované zdrojové dokumenty
- naplánované překlady
- překlady přeskočené, protože jsou již aktuální
- dokončené překlady
- neúspěšné překlady
- aktuální stav úlohy
Odeslání stejného výběru, když je aktivní ekvivalentní úloha, se znovu připojí k existující úloze místo vytváření duplicitní práce.
CMS ukládá identifikátor aktivní úlohy lokálně, aby bylo možné obnovit průběh po navigaci. Stav překladové úlohy momentálně drží ve své paměti správce překladů a při restartu služby se vymaže. Nasazujte službu jako jednu instanci nebo použijte směrování se zachováním relace, aby požadavky na odeslání úlohy a dotazy na stav dorazily do stejného procesu.
Detekce zastaralých překladů
Každý přeložený dokument ukládá hash publikovaného obsahu zdrojového dokumentu v okamžiku, kdy byl přeložen.
Když se odešle další překladová dávka:
- shodné hodnoty hash znamenají, že překlad je aktuální a může být přeskočen
- odlišné hodnoty hash ukazují, že se zdroj změnil a překlad by se měl znovu vygenerovat
Díky tomu je hromadný překlad bezpečné spouštět opakovaně bez opětovného překládání nezměněného obsahu.
Koncové body API
POST /translation — zařadí překlady pro jednu nebo více komponent do frontyGET /translation-jobs/{job_id} — získá stav a průběh překladové úlohyPATCH /translations — ručně opraví přeložený obsah
Systémové prvky
- dialog hromadného překladu v CMS
- ovládací prvky stavu překladových úloh a obnovení v CMS
- API správce překladů a pracovníci na pozadí
- integrace překladu TensorZero
- jazykově specifická zobrazení dokumentů v CMS
- načítání obsahu v aplikaci dokumentace s ohledem na jazyk
- trvalé uložení překladů a sledování hashů zdrojů