Varför den finns
Plattformen behöver flerspråkig leverans av innehåll utan att duplicera eller förgrena den underliggande innehållsmodellen. Översättningsstöd skapar språkliga varianter på dokumentnivå som är länkade till sina källdokument samtidigt som det ursprungliga schemat och innehållsstrukturen bevaras.
Använd detta när
- översätter en eller flera komponenter till flera språk
- följer framstegen för ett bulköversättningsjobb
- försöker igen med misslyckade översättningar
- korrigerar maskinellt genererade översättningar manuellt
- läser översatt innehåll i en dokumentations- eller webbplatsapp
- bygger språkspecifika dokumentvyer i CMS:et
Vad som ingår
- bulkval av komponenter och språk i CMS:et
- asynkrona översättningsjobb med förloppsspårning
- dokumentöversättning med TensorZero som stöd
- automatisk överhoppning av översättningar som redan är aktuella
- avduplicering av identiska aktiva översättningsjobb
- återställning av pågående jobbs framsteg efter navigering i CMS:et
- kontroller för att försöka igen med misslyckade översättningar
- beständiga målspråksinställningar
- manuell korrigering av översättningar via patch-endpointen
- språkmedveten dokumenthämtning
- källhashar för att upptäcka inaktuella översättningar
- översättningsmedvetna databaskolumner och index
Grundläggande arbetsflöde
- Öppna sidan Komponenter och välj Skicka till översättning.
- Välj en eller flera komponenter och målspråk.
- Granska det uppskattade antalet översättningar och ställ batchen i kö.
- Översättningshanteraren läser in de publicerade källdokumenten och hoppar över översättningar vars källhash redan är aktuell.
- Resterande översättningar behandlas asynkront via TensorZero.
- Övervaka köade, slutförda, överhoppade och misslyckade översättningar från CMS:et.
- Försök igen med misslyckade översättningar vid behov.
- Korrigera översatt innehåll manuellt när maskinellt genererat resultat behöver justeras.
- Läs översatta varianter via språkmedvetna schema- och dokument-API:er.
Översättningsjobb
Att skicka in en batch skapar ett översättningsjobb. Ett jobb registrerar:
- valda komponenter och språk
- bearbetade källdokument
- schemalagda översättningar
- översättningar som hoppades över eftersom de redan är aktuella
- slutförda översättningar
- misslyckade översättningar
- aktuell jobbstatus
Att skicka in samma urval medan ett likvärdigt jobb är aktivt återansluter till det befintliga jobbet i stället för att skapa dubbelt arbete.
CMS:et lagrar den aktiva jobbidentifieraren lokalt så att framstegen kan återställas efter navigering. Översättningsjobbets tillstånd hålls för närvarande i minnet av översättningshanteraren och rensas när tjänsten startar om. Distribuera tjänsten som en enskild instans eller använd klibbig routing så att jobbinlämningar och statusförfrågningar når samma process.
Identifiering av inaktuella översättningar
Varje översatt dokument lagrar en hash av källdokumentets publicerade innehåll vid tidpunkten för översättningen.
När en annan översättningsbatch skickas in:
- matchande hashar indikerar att översättningen är aktuell och kan hoppas över
- avvikande hashar indikerar att källan har ändrats och att översättningen bör återskapas
Detta gör det säkert att köra bulköversättning upprepade gånger utan att översätta om oförändrat innehåll.
API-slutpunkter
POST /translation — ställ översättningar för en eller flera komponenter i köGET /translation-jobs/{job_id} — läs översättningsjobbets status och framstegPATCH /translations — korrigera översatt innehåll manuellt
Systemytor
- Dialogen för bulköversättning i CMS:et
- CMS-kontroller för översättningsjobbs status och återställning
- översättningshanterarens API och bakgrundsarbetare
- TensorZero-integrering för översättning
- CMS:ets språkspecifika dokumentvyer
- dokumentationsappens språkmedvetna innehållsladdning
- översättningspersistens och spårning av källhash