Ferramentas de desenvolvimento
Traduza arquivos, faça chamadas à API pelo seu servidor e renderize aplicações multilíngues com pacotes JavaScript.
A localização conecta dois tipos de código: o que produz traduções e o que as utiliza. Um servidor pode solicitar conteúdo traduzido quando um registro é alterado. Um processo de compilação pode reunir arquivos traduzidos. Um componente React pode ler um catálogo existente sem fazer nenhuma solicitação de tradução.
Comece pela parte que você está implementando. Cada seção apresenta uma tarefa inicial completa, seguida dos contratos necessários para dar continuidade ao trabalho.
API #
Use a API quando seu servidor já armazena o conteúdo e deve decidir quando solicitar uma tradução, onde armazená-la e quando utilizá-la. Envie conteúdo JSON ou arquivos como uma tarefa de tradução, inicie a tarefa e recupere cada resultado concluído nos idiomas de destino. O engine controla as etapas de tradução e revisão.
O guia Faça sua primeira solicitação mostra como enviar um pequeno conjunto de dados e salvar os dados traduzidos localmente. Ele explica a credencial, a escolha do engine de localização, os campos da resposta e as verificações a fazer antes de conectar esse processo ao armazenamento da aplicação.
CLI #
Use a CLI quando o conteúdo estiver em arquivos. Configure os caminhos de origem e os idiomas de destino, envie o trabalho selecionado e baixe os arquivos de destino para o seu projeto. A CLI registra versões de referência dos arquivos de origem para que as próximas execuções processem as alterações, em vez de tratar todos os arquivos como novos.
O guia Traduza seu primeiro arquivo aborda instalação, autenticação, configuração e download dos arquivos. A mesma CLI pode extrair mensagens explícitas do React para catálogos; a extração é local e não solicita traduções.
JavaScript #
Os pacotes JavaScript abrangem clientes para servidor, renderização de mensagens em React e roteamento por idioma. Escolha um cliente para fazer solicitações de tradução ou uma biblioteca de renderização para exibir mensagens já disponíveis na aplicação. A renderização no navegador não exige uma chave de API de tradução.
A documentação do React inclui um exemplo local para exibir a primeira mensagem, carregamento de catálogos, alternativas gramaticais, texto rico e integração específica para cada framework. A negociação de URL e o texto traduzido são responsabilidades distintas, por isso as referências de roteamento explicam como manter as mensagens carregadas alinhadas ao idioma selecionado.
Traga um projeto existente #
A seção Formatos explica o que cada processador traduz e reconstrói. Confira também a lista de formatos da ferramenta que aciona o processador: um processador disponível em uma integração no servidor não corresponde necessariamente a um formato de arquivo configurado na CLI.
Projetos que usam i18n.json ou LingoDotDevEngine contam com referências versionadas da CLI v0 e do SDK v0. Mantenha a versão instalada enquanto planeja a migração; a configuração, o estado preservado e os valores de retorno podem mudar entre gerações.
Para um assistente que trabalha com arquivos locais ou com a configuração da conta, use o MCP. Para traduções conectadas a um repositório, CMS ou central de ajuda, use Integrações. Cada conexão define como o trabalho começa, quais autorizações utiliza e para onde os resultados retornam.