DevTools

Traduza ficheiros, faça chamadas à API a partir do seu servidor e apresente aplicações multilingues com pacotes JavaScript.

A localização liga dois tipos de código: o que produz traduções e o que as utiliza. Um servidor pode pedir conteúdo traduzido quando um registo é alterado. Um processo de compilação pode recolher ficheiros traduzidos. Um componente React pode ler um catálogo existente sem sequer fazer um pedido de tradução.

Comece pela parte que está a implementar. Cada secção apresenta uma primeira tarefa completa, seguida dos contratos necessários para dar continuidade ao trabalho.

API #

Utilize a API quando o conteúdo já está no seu servidor e é este que deve decidir quando pedir uma tradução, onde a guardar e quando a utilizar. Submeta conteúdo JSON ou ficheiros carregados como uma tarefa de tradução, inicie-a e obtenha o resultado de cada idioma de destino à medida que fica concluído. O motor controla as etapas de tradução e revisão da tarefa.

O guia Faça o seu primeiro pedido mostra como enviar um pequeno conjunto de dados e guardar os dados traduzidos localmente. Explica a credencial, a seleção do motor de localização, os campos da resposta e as verificações a efetuar antes de ligar este processo ao armazenamento da aplicação.

CLI #

Utilize a CLI quando o conteúdo está em ficheiros. Configure os caminhos de origem e os idiomas de destino, submeta o trabalho selecionado e obtenha os ficheiros de destino no seu projeto. A CLI regista versões de referência dos ficheiros de origem para que as execuções seguintes possam processar apenas as alterações, em vez de tratar todos os ficheiros como novos.

O guia Traduza o seu primeiro ficheiro abrange a instalação, a autenticação, a configuração e a obtenção dos resultados. A mesma CLI permite extrair mensagens explícitas do React para catálogos; a extração é feita localmente e não gera pedidos de tradução.

JavaScript #

Os pacotes JavaScript abrangem clientes para servidor, apresentação de mensagens em React e encaminhamento por idioma. Escolha um cliente para fazer pedidos de tradução ou uma biblioteca de apresentação para as mensagens já disponíveis na aplicação. A apresentação no navegador não requer uma chave de API de tradução.

A documentação do React inclui um exemplo local para apresentar a primeira mensagem, carregamento de catálogos, alternativas gramaticais, texto formatado e integração específica para cada estrutura de desenvolvimento. A negociação de URLs e o texto traduzido são responsabilidades distintas, pelo que a documentação de referência sobre encaminhamento explica como manter o idioma selecionado e as mensagens carregadas em sintonia.

Integre um projeto existente #

A secção Formatos explica o que cada processador traduz e reconstrói. Consulte também a lista de formatos da ferramenta que o invoca: um processador disponível numa integração de servidor não corresponde necessariamente a um formato de ficheiro configurado na CLI.

Os projetos que utilizam i18n.json ou LingoDotDevEngine dispõem de documentação de referência específica para CLI v0 e SDK v0. Mantenha a versão instalada enquanto planeia a migração; a configuração, o estado preservado e os valores devolvidos podem mudar entre gerações.

Para um assistente que trabalha com ficheiros locais ou com a configuração da conta, utilize MCP. Para ligar a tradução a um repositório, CMS ou centro de ajuda, utilize Integrações. Cada ligação define como o trabalho é iniciado, com que autoridade é executado e para onde são devolvidos os resultados.