Por que existe
A plataforma precisa entregar conteúdo multilíngue sem duplicar ou bifurcar o modelo de conteúdo subjacente. O suporte a tradução cria variantes de idioma em nível de documento vinculadas aos seus documentos de origem, preservando o esquema e a estrutura de conteúdo originais.
Use quando
- traduzir um ou mais componentes para vários idiomas
- acompanhar o progresso de um trabalho de tradução em lote
- repetir traduções que falharam
- corrigir manualmente traduções geradas por máquina
- ler conteúdo traduzido em um aplicativo de documentação ou site
- criar visualizações de documentos específicas por idioma no CMS
O que inclui
- seleção em lote de componentes e idiomas no CMS
- trabalhos de tradução assíncronos com acompanhamento de progresso
- tradução de documentos com suporte do TensorZero
- pular automaticamente traduções que já estão atualizadas
- deduplicação de trabalhos de tradução ativos idênticos
- recuperação do progresso de trabalhos ativos após navegação no CMS
- controles de repetição para traduções que falharam
- preferências persistentes de idioma de destino
- correção manual de traduções por meio do endpoint PATCH
- recuperação de documentos com reconhecimento de idioma
- hashes de origem para detectar traduções obsoletas
- colunas e índices de banco de dados compatíveis com traduções
Fluxo de trabalho principal
- Abra a página Componentes e selecione Enviar para tradução.
- Escolha um ou mais componentes e idiomas de destino.
- Analise o número estimado de traduções e coloque o lote na fila.
- O gerenciador de traduções carrega os documentos de origem publicados e ignora as traduções cujo hash de origem já está atualizado.
- As traduções restantes são processadas de forma assíncrona pelo TensorZero.
- Monitore traduções enfileiradas, concluídas, ignoradas e com falha no CMS.
- Repita as traduções que falharam quando necessário.
- Corrija manualmente o conteúdo traduzido quando o resultado gerado por máquina precisar de ajuste.
- Leia variantes traduzidas por meio de esquemas e APIs de documentos com reconhecimento de idioma.
Trabalhos de tradução
Enviar um lote cria um trabalho de tradução. Um trabalho registra:
- componentes e idiomas selecionados
- documentos de origem processados
- traduções programadas
- traduções ignoradas porque já estão atualizadas
- traduções concluídas
- traduções com falha
- status atual do trabalho
Enviar a mesma seleção enquanto um trabalho equivalente está ativo reconecta ao trabalho existente em vez de criar trabalho duplicado.
O CMS armazena localmente o identificador do trabalho ativo para que o progresso possa ser restaurado após a navegação. O estado do trabalho de tradução é mantido em memória pelo gerenciador de traduções e é limpo quando o serviço reinicia. Faça o deploy do serviço como uma única instância ou use roteamento fixo para que o envio de trabalhos e as solicitações de status cheguem ao mesmo processo.
Detecção de traduções desatualizadas
Cada documento traduzido armazena um hash do conteúdo publicado do documento de origem no momento em que foi traduzido.
Quando outro lote de tradução é enviado:
- hashes correspondentes indicam que a tradução está atualizada e pode ser ignorada
- hashes diferentes indicam que a origem mudou e que a tradução deve ser regenerada
Isso torna seguro executar traduções em lote repetidamente sem retraduzir conteúdo inalterado.
Endpoints de API
POST /translation — coloca traduções na fila para um ou mais componentesGET /translation-jobs/{job_id} — lê o status e o progresso de um trabalho de traduçãoPATCH /translations — corrige manualmente conteúdo traduzido
Superfícies do sistema
- diálogo de tradução em lote do CMS
- controles de status e recuperação de trabalhos de tradução no CMS
- API do gerenciador de traduções e workers em segundo plano
- integração de tradução do TensorZero
- visualizações de documentos específicas por idioma no CMS
- carregamento de conteúdo com reconhecimento de idioma no app de documentação
- persistência de traduções e rastreamento de hash de origem