Skip to content

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 ​

FrameworkStrings do shell / temaPipeline
DocusaurusCatálogo write-translations ({ message, description })Documentos — docs[].docusaurusCatalogDir + translate-docs
VitePressCatálogo de tema/navegação/barra lateralDocumentos — docsOutput.vitepressThemeCatalog + translate-docs
NextraRótulos da barra lateral _meta.tsDocumentos — automático quando style: "nextra" + translate-docs
NextraDicionário de tema .tsDocumentos — docs[].nextraDictionaryPath + translate-docs
FumadocsRótulos da barra lateral meta.jsonDocumentos — automático quando style: "fumadocs" + translate-docs
FumadocsCatálogo de substituições de UIDocumentos — docsOutput.fumadocsUiCatalog + translate-docs
Astro StarlightStrings de UI integradas (muitas localidades); sem pipeline de shell adicionalDocumentos — 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 ​

FrameworkRepositório de exemplo
Astro Starlightexamples/astro-docs
Site Astro puroexamples/astro-website
Docusaurusexamples/docusaurus-docs
VitePressexamples/vitepress-docs
Nextraexamples/nextra-docs
Fumadocsexamples/fumadocs-docs
Streamlitexamples/python-streamlit
Flaskexamples/python-flask
FastAPIexamples/python-fastapi
GNU gettextexamples/python-gettext
Auxiliar JSON .NETexamples/dotnet-console
Auxiliar ResourceManager .NETexamples/dotnet-resx

Lançado sob a Licença MIT.