Skip to content

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 testadosExtrai 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 READMEArmazena 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 READMEMostra 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ê temComece aqui
Um app JS/TS (React, Next.js, Node, CLI) com texto simples no código-fonteAdicionar 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 IStringLocalizerAdicionar i18n a um aplicativo .NET ResourceManager
Um aplicativo Django, catálogos Flask-Babel ou um aplicativo que já usa GNU gettextAdicionar 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 appAdicionar i18n ao seu README e à documentação em Markdown
Arquivos de locale JSON aninhados independentesJSON
Diagramas SVG com rótulos de textoTraduçã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 ​

  1. Instale a CLI e defina a chave de API do seu provedor: Instalação.
  2. Execute init para gravar ai-i18n-tools.config.json: Início rápido.
  3. 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.
  4. Execute sync. Ele extrai o texto, traduz o que é novo e grava a saída.
  5. Carregue a saída no seu app ou site, adicione um seletor de idioma e execute sync novamente 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, e T("…") / {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 .astro listadas em docs[].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.style de flat). 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ê temExemplo
Um aplicativo JS/TSconsole-app, nextjs-app
Um README de repositório junto com um aplicativoconsole-app, nextjs-app
Um aplicativo Pythonpython-streamlit, python-fastapi, python-gettext
Um auxiliar .NETdotnet-console, dotnet-resx
Um site de documentaçãodocusaurus-docs, vitepress-docs, astro-docs
Um site ou HTML puroastro-website, plain-html

Consulte Exemplos para ver a lista completa e os comandos de cópia npx degit.

Próximas etapas ​

  1. 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.
  2. Início rápido — gere uma configuração inicial e execute sua primeira tradução.
  3. Provedores de LLM — escolha um provedor, uma chave de API e a substituição de -P.
  4. Modelos de IA — classifique uma lista restrita com suggest-models ou a guia Modelos do painel e mantenha vários modelos para que uma tradução com falha possa tentar o próximo.

Lançado sob a Licença MIT.