Como funciona

Acompanhe uma alteração de conteúdo desde a origem, passando pelas orientações de tradução guardadas, até chegar a um resultado que pode utilizar e verificar.

Ao escrever e rever conteúdo, decide o que pretende que os leitores compreendam, o que merece uma explicação mais aprofundada e que argumentos os podem convencer. A tradução deve transmitir esse significado e essa intenção persuasiva com a mesma precisão noutro idioma. O Lingo.dev utiliza modelos de linguagem para traduzir o seu conteúdo, com orientações guardadas sobre o seu produto, a sua terminologia e a sua voz.

Fornece o conteúdo de origem e os idiomas de que precisa e seleciona o motor de localização que fará a tradução. Nos pedidos à API, o motor é identificado com engineId; a CLI ou uma integração utiliza o motor de localização selecionado na respetiva configuração. Essa escolha determina os modelos e as orientações partilhadas disponíveis para o pedido. O conteúdo traduzido é devolvido através da ferramenta que o solicitou, enquanto as medições de qualidade e a revisão humana seguem os percursos que configurar.

Comece pelo conteúdo e pelo idioma de destino #

O conteúdo que fornece é a origem. Cada versão traduzida é um destino. O conteúdo de origem pode vir de um ficheiro, de dados estruturados numa aplicação ou de um sistema de conteúdos ligado. Os idiomas de origem e de destino indicados no pedido identificam as línguas envolvidas.

Um idioma identifica a língua e, quando necessário, a região ou o sistema de escrita. Defina explicitamente o público a que se destina: um pedido para pt-BR especifica português do Brasil, em vez de deixar a região por definir. Os idiomas de origem e de destino também ajudam o Lingo.dev a selecionar as orientações de tradução aplicáveis. A secção Resolução de idiomas explica essas regras de correspondência.

A estrutura do conteúdo é tão importante como o idioma. Uma aplicação utiliza chaves de mensagens para encontrar texto e variáveis para inserir valores. Um documento contém títulos, ligações e formatação. Nos pedidos à API, os dados estruturados são fornecidos diretamente; a CLI e os processadores de formatos extraem dos ficheiros o texto a traduzir e reconstroem as respetivas versões de destino. Cada percurso tem de devolver conteúdo que o sistema que o recebe continue a conseguir utilizar.

Ao guardar traduções ou analisá-las mais tarde, mantenha a versão do conteúdo de origem junto do resultado. Quando um autor altera o significado, uma tradução que estava correta para a versão anterior pode deixar de transmitir a mensagem pretendida.

Guarde o conhecimento de que os pedidos futuros vão precisar #

Um modelo de linguagem sabe trabalhar com a língua. Não conhece automaticamente a terminologia do seu produto, os requisitos acordados pela sua equipa nem a forma como a sua empresa comunica com os leitores. Um motor de localização guarda as escolhas de modelos e as ligações a orientações reutilizáveis, para que cada pedido possa utilizar esse conhecimento sem ter de o enviar novamente na íntegra.

Diferentes tipos de orientações respondem a diferentes perguntas:

  • Um glossário regista os termos, o significado pretendido e as formulações preferidas ou os nomes que devem ficar por traduzir. Ajuda o modelo a distinguir um conceito do produto de outra utilização da mesma palavra.
  • Um conjunto de regras contém instruções de tradução. Permite definir requisitos recorrentes que uma lista de termos não consegue abranger, incluindo distinções de significado que o conteúdo traduzido deve preservar.
  • A voz da marca descreve a forma como a empresa comunica com os seus leitores, incluindo o tom e o grau de formalidade.

Os glossários, os conjuntos de regras e as vozes da marca pertencem à sua organização e podem ser associados a vários motores de localização. Os workflows relacionados podem partilhar terminologia e manter escolhas de modelos ou de voz diferentes quando necessário. Alterar um recurso partilhado pode afetar todos os motores de localização que o utilizam, por isso verifique as respetivas associações ao modificar as orientações.

Para cada pedido, o Lingo.dev seleciona os termos relevantes do glossário, as instruções aplicáveis, uma variante de voz e os modelos candidatos do motor de localização escolhido. Um documento JSON também pode fornecer format.options.context para descrever o público ou a finalidade e format.options.hints para chaves individuais. Assim, pode manter o conhecimento partilhado no motor de localização e explicar o que é específico do conteúdo a traduzir. A secção Contexto de tradução aborda estas opções em pormenor.

Predefinições do formulário de criação #

O formulário de criação da aplicação Web apresenta as seguintes predefinições. Pode alterar os modelos e selecionar orientações existentes antes de concluir a criação.

DefiniçãoPredefinição do formulário
ModelosUm modelo principal recomendado e um modelo alternativo abrangem todos os pares de idiomas. Pode alterar os modelos ou configurar um par específico separadamente.
Glossários, conjuntos de regras e voz da marcaNenhum recurso associado por predefinição. Selecione recursos existentes durante a criação ou associe-os mais tarde.
Sequência de processamentoApenas tradução. As etapas opcionais de reescrita e revisão humana estão inicialmente desativadas.
Pontuação do glossário e das instruções; sugestõesA atribuição automática de pontuações, a geração de sugestões e a aplicação automática de sugestões estão inicialmente desativadas.

Os motores de localização existentes podem ter outras definições guardadas. Verifique o motor que será utilizado nos seus pedidos, em vez de partir do princípio de que a configuração ainda corresponde às predefinições. A secção Criar e configurar um motor de localização aborda as escolhas de modelos e as associações de recursos.

Gere a versão de destino e devolva-a a quem fez o pedido #

O modelo de linguagem selecionado recebe o conteúdo de origem e o contexto aplicável. Se o primeiro modelo configurado não conseguir concluir o pedido, o motor de localização pode recorrer ao modelo alternativo. Este permite uma nova tentativa; não compara as duas traduções para escolher a que tem a pontuação de qualidade mais elevada.

Com a API, cria e inicia uma tarefa de tradução e, depois, descarrega as versões de destino concluídas. O resultado em JSON mantém as chaves de mensagens do documento, e a sua aplicação decide onde o guardar ou utilizar. Com a CLI, os comandos push e pull executam por si este workflow de ficheiros. Cada integração tem a sua própria forma de gravar os resultados no sistema de origem, como abrir um pedido de integração com as traduções. A secção Integrações explica o que cada ligação lê e escreve.

A estrutura devolvida liga a tradução ao resto do seu trabalho. Verifique se a aplicação consegue carregar o catálogo, substituir as variáveis ou apresentar as ligações e a formatação do documento. Estas verificações confirmam que o sistema que recebe o resultado o consegue utilizar; medir a qualidade linguística exige outro tipo de evidência.

Verifique o resultado no workflow que o utiliza #

Escolha as medições em função do que é importante no seu conteúdo. Verificar se o significado foi preservado exige o conteúdo de origem e a respetiva tradução, com contexto suficiente para compreender a intenção do autor. Uma verificação ortográfica pode basear-se apenas na versão de destino. As evidências diferem porque as perguntas são diferentes. O resultado é útil quando consegue ver o que foi verificado e analisar o excerto em que a resposta se baseia.

A sequência de processamento do motor pode incluir revisão humana antes de a tarefa produzir o resultado final. Consulte a política de revisão para conhecer a cobertura, o encaminhamento e o que acontece quando o tempo limite é excedido: uma versão de destino concluída pode não ter passado por revisão ou ter prosseguido após o fim do tempo limite. As medições de qualidade independentes são executadas separadamente, pelo que a conclusão de uma tradução não equivale a um relatório de qualidade concluído nem comprova a aprovação por uma pessoa.

As medições também podem analisar traduções produzidas fora do Lingo.dev. Pode manter o seu sistema de geração atual e consultar Medir para saber qual o método suportado para analisar o respetivo resultado. A medição responde a uma pergunta definida sobre o texto fornecido; cabe à sua equipa decidir o que o resultado significa para a utilização desse texto.

Se uma revisão revelar um problema terminológico recorrente, corrija a tradução atual e pondere uma alteração separada ao glossário ou às instruções para trabalhos futuros. Atualizar as orientações partilhadas não reescreve todas as traduções anteriores. A secção Sugestões descreve como são tratadas as propostas de alteração das orientações.

Para traduzir conteúdo de uma aplicação, faça o seu primeiro pedido à API. O guia acompanha um pequeno conjunto de dados ao longo da configuração, da tradução e da análise de um ficheiro de destino guardado. Se o seu conteúdo de origem já estiver em ficheiros, o guia de início rápido da CLI acompanha esse percurso até à obtenção dos resultados.