Por qué existe
La plataforma necesita la entrega de contenido multilingüe sin duplicar ni bifurcar el modelo de contenido subyacente. La compatibilidad con traducciones crea variantes idiomáticas a nivel de documento vinculadas a sus documentos fuente, preservando el esquema original y la estructura del contenido.
Úsalo cuando
- traducir uno o más componentes a varios idiomas
- hacer un seguimiento del progreso de un trabajo de traducción masiva
- reintentar traducciones fallidas
- corregir manualmente traducciones generadas por máquina
- leer contenido traducido en una aplicación de documentación o de sitio web
- crear vistas de documentos específicas por idioma en el CMS
Lo que incluye
- selección masiva de componentes e idiomas en el CMS
- trabajos de traducción asíncronos con seguimiento del progreso
- traducción de documentos respaldada por TensorZero
- omisión automática de las traducciones que ya están al día
- deduplicación de trabajos de traducción activos idénticos
- recuperación del progreso de trabajos activos después de la navegación en el CMS
- controles de reintento para traducciones fallidas
- preferencias de idioma de destino persistentes
- corrección manual de traducciones mediante el endpoint de patch
- recuperación de documentos con reconocimiento de idioma
- hashes de origen para detectar traducciones obsoletas
- columnas e índices de base de datos con reconocimiento de traducción
Flujo de trabajo principal
- Abre la página de Componentes y selecciona Enviar a traducción.
- Elige uno o más componentes e idiomas de destino.
- Revisa el número estimado de traducciones y encola el lote.
- El gestor de traducciones carga los documentos fuente publicados y omite las traducciones cuyo hash de origen ya está al día.
- Las traducciones restantes se procesan de forma asíncrona mediante TensorZero.
- Supervisa las traducciones en cola, completadas, omitidas y fallidas desde el CMS.
- Reintenta las traducciones fallidas cuando sea necesario.
- Corrige el contenido traducido manualmente cuando el resultado generado por máquina necesite ajustes.
- Lee las variantes traducidas mediante esquemas y API de documentos con reconocimiento de idioma.
Trabajos de traducción
Enviar un lote crea un trabajo de traducción. Un trabajo registra:
- componentes e idiomas seleccionados
- documentos fuente procesados
- traducciones programadas
- traducciones omitidas porque ya están al día
- traducciones completadas
- traducciones fallidas
- estado actual del trabajo
Enviar la misma selección mientras un trabajo equivalente está activo se reconecta al trabajo existente en lugar de crear trabajo duplicado.
El CMS almacena localmente el identificador del trabajo activo para poder restaurar el progreso después de la navegación. El estado del trabajo de traducción se mantiene actualmente en memoria por el gestor de traducciones y se borra cuando el servicio se reinicia. Implementa el servicio como una sola instancia o usa enrutamiento sticky para que las solicitudes de envío de trabajos y de estado lleguen al mismo proceso.
Detección de traducciones obsoletas
Cada documento traducido almacena un hash del contenido publicado del documento fuente en el momento en que fue traducido.
Cuando se envía otro lote de traducción:
- los hashes coincidentes indican que la traducción está al día y puede omitirse
- los hashes diferentes indican que la fuente cambió y la traducción debe regenerarse
Esto hace que la traducción masiva sea segura de ejecutar repetidamente sin retraducir contenido sin cambios.
Endpoints de la API
POST /translation — poner en cola traducciones para uno o más componentesGET /translation-jobs/{job_id} — consultar el estado y el progreso de un trabajo de traducciónPATCH /translations — corregir manualmente el contenido traducido
Superficies del sistema
- diálogo de traducción masiva del CMS
- controles de estado y recuperación de trabajos de traducción del CMS
- API del gestor de traducciones y trabajadores en segundo plano
- integración de traducción con TensorZero
- vistas de documentos del CMS específicas por idioma
- carga de contenido con reconocimiento de idioma en la aplicación de documentación
- persistencia de traducciones y seguimiento de hash de origen