De ce există
Platforma are nevoie de livrare de conținut multilingv fără a duplica sau deriva modelul de conținut de bază. Suportul pentru traduceri creează variante de limbă la nivel de document legate de documentele sursă, păstrând în același timp schema și structura de conținut originale.
Folosește acest lucru când
- traduci una sau mai multe componente în mai multe limbi
- urmărești progresul unui job de traducere în masă
- retrimiți traducerile eșuate
- corectezi manual traducerile generate automat
- citești conținutul tradus într-o aplicație de documentație sau într-un site web
- construiești vizualizări de documente specifice limbii în CMS
Ce include
- selecție în masă a componentelor și limbilor în CMS
- joburi de traducere asincrone cu urmărirea progresului
- traducerea documentelor susținută de TensorZero
- omiterea automată a traducerilor care sunt deja actuale
- deduplicarea joburilor de traducere active identice
- recuperarea progresului joburilor active după navigarea în CMS
- controale de retrimitere pentru traducerile eșuate
- preferințe persistente pentru limba țintă
- corectarea manuală a traducerii prin endpoint-ul patch
- recuperarea documentelor în funcție de limbă
- hash-uri ale surselor pentru detectarea traducerilor învechite
- coloane și indexuri de bază de date adaptate traducerilor
Flux de lucru de bază
- Deschide pagina Components și selectează Send to translation.
- Alege una sau mai multe componente și limbile țintă.
- Verifică numărul estimat de traduceri și pune lotul în coadă.
- Managerul de traduceri încarcă documentele sursă publicate și sare peste traducerile al căror hash al sursei este deja actual.
- Traducerile rămase sunt procesate asincron prin TensorZero.
- Monitorizează din CMS traducerile puse în coadă, finalizate, omise și eșuate.
- Retrimite traducerile eșuate atunci când este necesar.
- Corectează manual conținutul tradus atunci când rezultatul generat automat necesită ajustări.
- Citește variantele traduse prin API-urile de schemă și document conștiente de limbă.
Joburi de traducere
Trimiterea unui lot creează un job de traducere. Un job înregistrează:
- componentele și limbile selectate
- documentele sursă procesate
- traducerile programate
- traducerile omise deoarece sunt deja actuale
- traducerile finalizate
- traducerile eșuate
- starea curentă a jobului
Trimiterea aceleiași selecții în timp ce un job echivalent este activ se reconectează la jobul existent în loc să creeze muncă duplicată.
CMS-ul stochează local identificatorul jobului activ, astfel încât progresul să poată fi restaurat după navigare. Starea jobului de traducere este în prezent păstrată în memorie de către managerul de traduceri și este ștearsă atunci când serviciul este repornit. Rulează serviciul ca o singură instanță sau folosește routing sticky pentru ca trimiterea joburilor și cererile de status să ajungă la același proces.
Detectarea traducerilor învechite
Fiecare document tradus stochează un hash al conținutului publicat al documentului sursă la momentul traducerii.
Când este trimis un alt lot de traducere:
- hash-urile care coincid indică faptul că traducerea este actuală și poate fi omisă
- hash-urile diferite indică faptul că sursa s-a schimbat și traducerea trebuie regenerată
Acest lucru face ca traducerea în masă să poată fi rulată în siguranță în mod repetat fără a retraduce conținutul neschimbat.
Endpoint-uri API
POST /translation — pune în coadă traduceri pentru una sau mai multe componenteGET /translation-jobs/{job_id} — citește statusul și progresul jobului de traducerePATCH /translations — corectează manual conținutul tradus
Suprafețe ale sistemului
- dialogul de traducere în masă din CMS
- controalele de status și recuperare pentru joburi de traducere în CMS
- API-ul managerului de traduceri și workerii de fundal
- integrarea de traducere TensorZero
- vizualizări de documente specifice limbii în CMS
- încărcarea de conținut conștient de limbă în aplicația de documentație
- persistența traducerilor și urmărirea hash-urilor sursă