Um idioma hoje? Comece aqui. Esse idioma pode ser qualquer um: defina-o como sourceLocale. O inglês é um exemplo comum nestes guias. A internacionalização (i18n) prepara seu projeto para suportar diferentes idiomas; estes guias levam você da configuração até sua primeira experiência traduzida, incluindo o README que seu repositório já exibe no GitHub, GitLab ou em qualquer outro host.
Aplicativo JavaScript ou TypeScript
Transforme botões, rótulos e mensagens de texto simples em uma IU multilíngue. Configure seu ambiente de execução, marque o texto a ser traduzido e conecte a troca de idioma. Inclui prompts do agente de codificação para a etapa de preparação.
React · Next.js · Node.js · CLI
Adicionar i18n a um aplicativo JS/TS
Aplicativo Python
Encapsule o texto voltado para o usuário e carregue mensagens traduzidas com um auxiliar gerado. Já usa Django ou GNU gettext? Mantenha suas chamadas gettext e deixe a ferramenta preencher os arquivos .po. Execute a CLI de tradução a partir de um executável autônomo, sem uma instalação separada do Node.js.
Streamlit · FastAPI · Flask · Django · CLI
Adicionar i18n a um aplicativo Python · Adicionar i18n a um aplicativo Django / Python gettext
Aplicativo .NET
Encapsule texto C# e XAML e carregue traduções de JSON incorporado, ou mantenha ResourceManager e escreva satélites .resx. Um comando de simulação transforma a interpolação em chamadas T() e lista chaves de recurso nomeadas, como Resources.LoginButton, para você converter.
Avalonia · WPF · MAUI · ASP.NET · Blazor
Adicionar i18n a um aplicativo .NET · Adicionar i18n a um aplicativo .NET ResourceManager
Site ou documentação
Publique páginas localizadas e conecte-as às rotas de idioma do seu site. Siga as etapas específicas do framework para navegação, rótulos de tema e o menu de idioma.
VitePress · Starlight · Docusaurus · Astro
Adicionar i18n a um site ou site de documentação
README e documentos do repositório
Traduza o README.md e outros arquivos Markdown em um arquivo por idioma, com uma linha de links entre eles. Combine-o com as strings da interface do seu app ou traduza o README separadamente.
GitHub · GitLab · Bitbucket
Adicionar i18n ao seu README e documentos Markdown
Não tem certeza de qual caminho seguir? O guia Adicionar i18n ao seu projeto lista todos os tutoriais. Veja o que o ai-i18n-tools faz para entender como os pipelines se encaixam.
Da configuração ao seu primeiro novo idioma
- Prepare seu projeto. Escolha seus idiomas, um provedor de tradução e os modelos a serem testados. Para aplicativos, marque o texto voltado para o usuário e configure o ambiente de execução de tradução. Para sites, habilite o roteamento de idioma do seu framework. Os guias incluem prompts do agente de codificação onde são necessárias alterações no código-fonte.
- Traduza para arquivos que você pode usar. Assim que a configuração estiver pronta, execute
sync. Ele extrai strings de aplicativo compatíveis, traduz o conteúdo que você habilitou e escreve arquivos de localidade ou páginas localizadas. - Carregue, verifique e continue. Conecte a saída ao seu aplicativo ou site, conecte a troca de idioma e verifique um idioma de destino. Execute novamente após alterações no código-fonte para traduzir texto novo ou alterado.
Você cuida da configuração do runtime e do roteamento, manualmente ou com um agente de codificação. A CLI cuida da extração, tradução, validação e geração de arquivos — não da reescrita automática do código-fonte ou da instalação do seletor de idiomas. Siga o guia de início rápido completo.
Seu texto de origem. Pronto para mais idiomas.
Este exemplo ilustrativo de JS/TS mostra o formato do resultado após a configuração e a tradução em tempo de execução. Marcar a string de origem a torna detectável; cada arquivo de localidade gerado mapeia essa frase para a tradução correspondente.
A frase original permanece legível em seu código. Seu aplicativo carrega os arquivos de localidade gerados em tempo de execução. Quer ver a configuração completa? Explore o exemplo funcional do Next.js. Sites seguem um caminho diferente: gerar páginas localizadas em vez de encapsular cada parágrafo.
Desenvolvido também para a próxima atualização
Escolha seu provedor e modelos
Use provedores compatíveis como OpenAI, Anthropic, OpenRouter, Gemini, Ollama local ou nove outras opções integradas. Você também pode usar qualquer provedor compatível com a OpenAI. A qualidade da tradução segue a lista de modelos (translationModels, mais substituições por localidade). O suggest-models e a mesma classificação no painel Modelos montam essa lista a partir de benchmarks de tradução publicados.
Provedores de LLM · Modelos de IA
Reutilize o trabalho já feito
As traduções em cache permitem que as reexecuções se concentrem em textos novos ou alterados, em vez de traduzir tudo novamente.
Manter as traduções
Revise a saída da IA localmente
Inspecione as traduções, corrija a formulação e gerencie a terminologia no Painel de Tradução.
Ver o dashboard
Mantenha o aplicativo e o conteúdo juntos
Traduza mensagens do aplicativo, documentação, JSONs de localidade aninhados e rótulos de texto SVG a partir de uma única configuração. Ative apenas o que você precisa.
Combinando pipelines
Uma única sync abrange as strings da UI e o Markdown do repositório, e escreve uma linha de idioma no README.
Adicionar i18n ao seu README e documentos Markdown
Veja primeiro um projeto em funcionamento
Estes exemplos incluem a configuração e os arquivos traduzidos commitados. Explore a saída sem uma chave de API; executar a tradução novamente exige um provedor configurado e, geralmente, uma chave. O Ollama local não precisa de chave de API.
Um aplicativo multilíngue
Veja componentes React, configuração de tempo de execução, plurais e troca de idioma em um projeto Next.js funcional.
Explorar o exemplo do Next.js
Python na prática
Veja como um aplicativo Streamlit encapsula suas mensagens e usa JSON traduzido sem adicionar um tempo de execução JavaScript ao aplicativo.
Explorar o exemplo do Streamlit
Documentos em mais idiomas
Veja páginas VitePress traduzidas juntamente com navegação e rótulos de tema localizados.
Explorar o exemplo do VitePress
Navegar por todos os exemplos executáveis, incluindo ajudantes .NET, HTML simples, outros frameworks e fluxos de trabalho de i18n existentes.
Já usa i18n? Mantenha o que funciona.
Você não precisa começar do zero.
Também tem diagramas? Traduza os rótulos de texto SVG juntamente com seu aplicativo ou documentação.
Pronto para adicionar seu primeiro idioma?
Aprofunde-se quando precisar
Integrações · Provedores de LLM · Modelos de IA · Configuração · Referência da CLI
Sobre este site
A interface e a documentação em outros idiomas foram traduzidas com o ai-i18n-tools. As traduções por IA podem conter erros.
Todos os nomes de produtos, logotipos e marcas registradas são propriedade de seus respectivos donos. Ícones e nomes são usados apenas para fins de identificação. Este projeto não é afiliado ou endossado por essas marcas.