Prečo existuje
Platforma potrebuje doručovanie obsahu vo viacerých jazykoch bez duplikovania alebo forkovania podkladového modelu obsahu. Podpora prekladov vytvára jazykové varianty na úrovni dokumentov, prepojené s ich zdrojovými dokumentmi pri zachovaní pôvodnej schémy a štruktúry obsahu.
Použite to vtedy, keď
- prekladáte jeden alebo viac komponentov do viacerých jazykov
- sledujete priebeh hromadnej prekladovej úlohy
- opakujete zlyhané preklady
- ručne korigujete strojovo generované preklady
- čítate preložený obsah v aplikácii dokumentácie alebo webovej aplikácii
- vytvárate jazykovo špecifické zobrazenia dokumentov v CMS
Čo obsahuje
- hromadný výber komponentov a jazykov v CMS
- asynchrónne prekladové úlohy so sledovaním postupu
- preklad dokumentov podporený TensorZero
- automatické preskakovanie prekladov, ktoré sú už aktuálne
- deduplikáciu identických aktívnych prekladových úloh
- obnovenie priebehu aktívnej úlohy po navigácii v CMS
- ovládacie prvky na opätovné spustenie zlyhaných prekladov
- trvalé preferencie cieľového jazyka
- manuálnu korekciu prekladu prostredníctvom koncového bodu PATCH
- jazykovo uvedomelé získavanie dokumentov
- hash hodnoty zdrojov na detekciu zastaraných prekladov
- stĺpce a indexy databázy zohľadňujúce preklady
Základný pracovný postup
- Otvorte stránku Komponenty a vyberte Odoslať na preklad.
- Vyberte jeden alebo viac komponentov a cieľové jazyky.
- Skontrolujte odhadovaný počet prekladov a zaraďte dávku do frontu.
- Správca prekladov načíta publikované zdrojové dokumenty a preskočí preklady, ktorých hash zdroja je už aktuálny.
- Zvyšné preklady sa spracúvajú asynchrónne cez TensorZero.
- Monitorujte čakajúce, dokončené, preskočené a zlyhané preklady priamo z CMS.
- V prípade potreby znovu spustite zlyhané preklady.
- Manuálne opravte preložený obsah, keď je potrebné upraviť strojovo generovaný výstup.
- Čítajte preložené varianty prostredníctvom jazykovo uvedomelých schém a dokumentových rozhraní API.
Prekladové úlohy
Odoslanie dávky vytvorí prekladovú úlohu. Úloha zaznamenáva:
- vybrané komponenty a jazyky
- spracované zdrojové dokumenty
- naplánované preklady
- preklady preskočené, pretože sú už aktuálne
- dokončené preklady
- zlyhané preklady
- aktuálny stav úlohy
Odoslanie rovnakého výberu, kým je ekvivalentná úloha aktívna, sa znovu pripojí k existujúcej úlohe namiesto vytvárania duplicitnej práce.
CMS ukladá identifikátor aktívnej úlohy lokálne, aby bolo možné obnoviť priebeh po navigácii. Stav prekladovej úlohy sa v súčasnosti drží v pamäti správcom prekladov a pri reštarte služby sa vymaže. Nasadzujte službu ako jednu inštanciu alebo použite prilepené smerovanie (sticky routing), aby požiadavky na odoslanie úlohy a na stav dorazili do rovnakého procesu.
Detekcia zastaraných prekladov
Každý preložený dokument ukladá hash publikovaného obsahu zdrojového dokumentu v čase, keď bol preložený.
Keď sa odošle ďalšia prekladová dávka:
- zhodné hashe naznačujú, že preklad je aktuálny a možno ho preskočiť
- odlišné hashe naznačujú, že zdroj sa zmenil a preklad treba znovu vygenerovať
Vďaka tomu je hromadný preklad bezpečné spúšťať opakovane bez prekladu nezmeneného obsahu.
Koncové body API
POST /translation — zaradiť preklady pre jeden alebo viac komponentov do frontuGET /translation-jobs/{job_id} — získať stav a priebeh prekladovej úlohyPATCH /translations — manuálne upraviť preložený obsah
Systémové rozhrania
- dialóg hromadného prekladu v CMS
- ovládacie prvky stavu a obnovy prekladových úloh v CMS
- API správcu prekladov a pracovníci na pozadí
- integrácia prekladu TensorZero
- jazykovo špecifické zobrazenia dokumentov v CMS
- jazykovo uvedomelé načítavanie obsahu v aplikácii dokumentácie
- pretrvávanie prekladov a sledovanie hashov zdroja