O que é ai-i18n-tools?
Você tem um app, um site, um site de documentação ou um README de repositório em um idioma e quer adicionar mais idiomas. Esse idioma é o sourceLocale e pode ser qualquer um. O inglês é um exemplo comum nestes guias. O ai-i18n-tools encontra o texto, traduz com os modelos do provedor de LLM que você escolher e grava os arquivos que seu projeto já carrega. Ele armazena em cache todos os resultados, para que as reexecuções enviem apenas textos novos ou alterados para o modelo.
O que você faz e o que a ferramenta faz
| Você | A ferramenta |
|---|---|
| Escolha os idiomas, um provedor e os modelos a serem testados | Extrai o texto, traduz, valida o resultado e grava os catálogos ou as páginas |
Torna o texto visível ao usuário visível para a ferramenta: chamadas t() no código do app, o i18n próprio do seu framework para um site ou um marcador de lista de idiomas em um README | Armazena traduções em cache e as reutiliza em cada nova execução |
| Conecte o resultado ao aplicativo, ao roteamento do site ou à linha de idioma do README | Mostra o progresso e permite que você revise as traduções no painel |
A ferramenta não reescreve seu código-fonte a menos que você execute migrate-python-i18n ou migrate-dotnet-i18n com --write. Prompts do agente de codificação são fornecidos para a etapa de encapsulamento. Ela não instala o i18next ou o i18n do framework do seu site, e não constrói seu seletor de idioma, embora auxiliares de tempo de execução sejam fornecidos para isso.
Por onde começo?
Os passo a passo estão agrupados em Adicionar i18n ao seu projeto, com a configuração compartilhada e uma página para cada tipo de projeto. Escolha uma linha:
| Você tem | Comece aqui |
|---|---|
| Um app JS/TS (React, Next.js, Node, CLI) com texto simples no código-fonte | Adicionar i18n a um app JS/TS |
| Um aplicativo Python (Streamlit, FastAPI, Flask, desktop, scripts) | Adicionar i18n a um aplicativo Python |
| Um aplicativo .NET (Avalonia, WPF, MAUI, ASP.NET, Blazor, console) | Adicionar i18n a um aplicativo .NET |
Um aplicativo .NET que já usa ResourceManager ou IStringLocalizer | Adicionar i18n a um aplicativo .NET ResourceManager |
| Um aplicativo Django, catálogos Flask-Babel ou um aplicativo que já usa GNU gettext | Adicionar i18n a um aplicativo Django / Python gettext |
| Um site ou site de documentação (VitePress, Docusaurus, Starlight, Nextra, Fumadocs, Astro, HTML simples) | Adicionar i18n a um site ou site de docs |
| Um README de repositório e outros arquivos Markdown, geralmente junto a um app | Adicionar i18n ao seu README e à documentação em Markdown |
| Arquivos de locale JSON aninhados independentes | JSON |
| Diagramas SVG com rótulos de texto | Tradução de SVG |
| Dicionários Intlayer (sair do Intlayer) | Migração do Intlayer |
| Dicionários Intlayer (manter o Intlayer, traduzir no local) | Traduzir o Intlayer no local |
Como funciona
- Instale a CLI e defina a chave de API do seu provedor: Instalação.
- Execute
initpara gravarai-i18n-tools.config.json: Início rápido. - Prepare o projeto: encapsule strings em
t(), habilite o i18n do framework do seu site ou adicione o marcador de lista de idiomas a um README. - Execute
sync. Ele extrai o texto, traduz o que é novo e grava a saída. - Carregue a saída no seu app ou site, adicione um seletor de idioma e execute
syncnovamente quando a origem mudar.
Modos de tradução
Por baixo dos panos, a ferramenta executa quatro pipelines. Sua configuração habilita os que você precisa, e sync os executa em ordem.
- Strings da UI — Extraia chamadas
t("…")e_()de JS/TS e Python, eT("…")/{loc:Tr '…'}de C# e XAML (incluindo GNU gettext e satélites .NET.resx) e grave JSON plano por localidade,.po/.mo, ou.resx. Comandos:extract,translate-ui,migrate-dotnet-i18n. Guia: Strings da UI. Python: Aplicativos Python. .NET: Aplicativos .NET e Adicionar i18n a um aplicativo .NET ResourceManager. - Documentos — Traduza páginas Markdown, MDX e
.astrolistadas emdocs[].contentPaths. Funciona com VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro e outros sites de documentação estáticos, e com um README de repositório (docsOutput.styledeflat). Comando:translate-docs. Guias: Documentos e Adicionar i18n ao seu README e documentos Markdown. - JSON — Traduza pacotes de localidade JSON aninhados (rótulos de tema, substituições de i18n, cópia de aplicativo não no código-fonte) definidos em
json[]de nível superior. Comando:translate-json. Guia: JSON. - SVG — Traduza texto visível dentro de ilustrações SVG (
<text>,<title>,<desc>) e grave um arquivo de saída por localidade. Separado da tradução de documentos. Comando:translate-svg. Guia: Tradução de SVG.
Muitos projetos combinam modos. A combinação comum é de strings de UI com o README do repositório. Um site de documentação, como o VitePress, é a outra combinação frequente. Consulte Combinando pipelines e Adicione i18n ao seu README e documentos Markdown.
Exemplos
O repositório inclui projetos de exemplo executáveis em examples/, cada um com sua própria configuração, saídas de localidade commitadas e README. Explore os arquivos traduzidos sem uma chave de API; para executar a tradução novamente, é necessária uma chave de provedor.
| Se você tem | Exemplo |
|---|---|
| Um aplicativo JS/TS | console-app, nextjs-app |
| Um README de repositório junto com um aplicativo | console-app, nextjs-app |
| Um aplicativo Python | python-streamlit, python-fastapi, python-gettext |
| Um auxiliar .NET | dotnet-console, dotnet-resx |
| Um site de documentação | docusaurus-docs, vitepress-docs, astro-docs |
| Um site ou HTML puro | astro-website, plain-html |
Consulte Exemplos para ver a lista completa e os comandos de cópia npx degit.
Próximas etapas
- Instalação — instale o pacote npm ou baixe o executável autônomo para um projeto Python e defina sua chave de API do provedor.
- Início rápido — gere uma configuração inicial e execute sua primeira tradução.
- Provedores de LLM — escolha um provedor, uma chave de API e a substituição de
-P. - Modelos de IA — classifique uma lista restrita com
suggest-modelsou a guia Modelos do painel e mantenha vários modelos para que uma tradução com falha possa tentar o próximo.