Integrações
Referência para as integrações de framework: o que elas compartilham e como suas strings de shell diferem. Para adicionar idiomas a um site, comece em Adicionar i18n a um site ou site de documentação. Para um aplicativo, comece em Adicionar i18n a um aplicativo JS/TS, Adicionar i18n a um aplicativo Python, ou Adicionar i18n a um aplicativo .NET. Para um README de repositório e outros arquivos Markdown, comece em Adicionar i18n ao seu README e documentos Markdown.
As integrações de documentação usam o pipeline de Documentos (translate-docs / sync) para o conteúdo da página; as strings de shell (navegação, barra lateral, tema) são tratadas dentro desse mesmo pipeline, onde indicado — e não através do pipeline de JSON separado. As aplicações Python usam o pipeline de strings de UI (extract / translate-ui).
Qual guia ler
A tabela de seleção, com um modelo de inicialização por framework, está em Adicionar i18n a um site ou site de documentação. O prompt de passo a passo nessa página habilita o i18n do framework. As páginas de integração abaixo mantêm os detalhes do catálogo de shell. Frameworks Python: Python.
Conceitos compartilhados
As integrações de framework de documentação compartilham o mesmo modelo de bloco docs[] descrito em Documents. Defina docsOutput.style para corresponder ao seu framework ("docusaurus", "vitepress", "nextra", "fumadocs" ou "astro-starlight"). Para o layout da pasta de saída e o comportamento de reescrita de links, consulte Output layouts e Link rewriting. A configuração do Python é separada: Python.
Cada init -t ui-* -P <provider> scaffold gera o bloco do provedor LLM desse preset. Antes de translate-docs ou sync, defina a chave de API correspondente — consulte Provedor e chave de API.
Consulte Tradução do shell do framework para uma comparação entre frameworks. Cada guia vinculada abaixo aborda a configuração para esse framework.
Tradução do shell do framework
| Framework | Strings do shell / tema | Pipeline |
|---|---|---|
| Docusaurus | Catálogo write-translations ({ message, description }) | Documentos — docs[].docusaurusCatalogDir + translate-docs |
| VitePress | Catálogo de tema/navegação/barra lateral | Documentos — docsOutput.vitepressThemeCatalog + translate-docs |
| Nextra | Rótulos da barra lateral _meta.ts | Documentos — automático quando style: "nextra" + translate-docs |
| Nextra | Dicionário de tema .ts | Documentos — docs[].nextraDictionaryPath + translate-docs |
| Fumadocs | Rótulos da barra lateral meta.json | Documentos — automático quando style: "fumadocs" + translate-docs |
| Fumadocs | Catálogo de substituições de UI | Documentos — docsOutput.fumadocsUiCatalog + translate-docs |
| Astro Starlight | Strings de UI integradas (muitas localidades); sem pipeline de shell adicional | Documentos — translate-docs (somente páginas) |
Não coloque strings de shell/tema do framework em json[] — esse pipeline é para pacotes de localização de aplicativos não relacionados. Os detalhes de configuração por framework estão nos guias vinculados em Qual guia ler.
Exemplos executáveis
| Framework | Repositório de exemplo |
|---|---|
| Astro Starlight | examples/astro-docs |
| Site Astro puro | examples/astro-website |
| Docusaurus | examples/docusaurus-docs |
| VitePress | examples/vitepress-docs |
| Nextra | examples/nextra-docs |
| Fumadocs | examples/fumadocs-docs |
| Streamlit | examples/python-streamlit |
| Flask | examples/python-flask |
| FastAPI | examples/python-fastapi |
| GNU gettext | examples/python-gettext |
| Auxiliar JSON .NET | examples/dotnet-console |
| Auxiliar ResourceManager .NET | examples/dotnet-resx |