Skip to content

Integraciones ​

Referencia para las integraciones de frameworks: qué comparten y en qué se diferencian sus cadenas de shell. Para añadir idiomas a un sitio, empieza en Añadir i18n a un sitio web o de documentación. Para una aplicación, empieza en Añadir i18n a una aplicación JS/TS, Añadir i18n a una aplicación Python o Añadir i18n a una aplicación .NET. Para un README de repositorio y otros archivos Markdown, empieza en Añadir i18n a tu README y documentos Markdown.

Las integraciones de documentación usan la pipeline Documentos (translate-docs / sync) para el contenido de la página; las cadenas de shell (navegación, barra lateral, tema) se gestionan dentro de esa misma pipeline donde se indica, no a través de la pipeline JSON separada. Las aplicaciones Python usan la pipeline cadenas de UI (extract / translate-ui).

Qué guía leer ​

La tabla de selección, con una plantilla de inicialización por framework, se encuentra en Añadir i18n a un sitio web o sitio de documentación. La indicación guiada de esa página habilita la i18n del framework. Las páginas de integración a continuación mantienen los detalles del catálogo de shell. Frameworks de Python: Python.

Conceptos compartidos ​

Las integraciones de frameworks de documentación comparten el mismo modelo de bloque docs[] descrito en Documents. Establezca docsOutput.style para que coincida con su framework ("docusaurus", "vitepress", "nextra", "fumadocs" o "astro-starlight"). Para conocer el diseño de la carpeta de salida y el comportamiento de reescritura de enlaces, consulte Output layouts y Link rewriting. La configuración de Python es independiente: Python.

Cada andamiaje init -t ui-* -P <provider> escribe el bloque del proveedor de LLM de ese preajuste. Antes de translate-docs o sync, establezca la clave de API correspondiente — consulte Proveedor y clave de API.

Consulte Traducción de shell de framework para una comparación entre frameworks. Cada guía enlazada a continuación cubre la configuración para ese framework.

Traducción del shell del framework ​

FrameworkCadenas de shell / temaPipeline
DocusaurusCatálogo write-translations ({ message, description })Documentos — docs[].docusaurusCatalogDir + translate-docs
VitePressCatálogo de tema/navegación/barra lateralDocumentos — docsOutput.vitepressThemeCatalog + translate-docs
NextraEtiquetas de barra lateral _meta.tsDocumentos — automático cuando style: "nextra" + translate-docs
NextraDiccionario de tema .tsDocumentos — docs[].nextraDictionaryPath + translate-docs
FumadocsEtiquetas de barra lateral meta.jsonDocumentos — automático cuando style: "fumadocs" + translate-docs
FumadocsCatálogo de anulaciones de UIDocumentos — docsOutput.fumadocsUiCatalog + translate-docs
Astro StarlightCadenas de UI integradas (muchas configuraciones regionales); sin pipeline de shell adicionalDocumentos — translate-docs (solo páginas)

No ponga cadenas de shell/tema de framework en json[]; esa canalización es para paquetes de configuración regional de aplicaciones no relacionados. Los detalles de configuración por framework se encuentran en las guías enlazadas desde Qué guía leer.

Ejemplos ejecutables ​

FrameworkRepositorio de ejemplo
Astro Starlightexamples/astro-docs
Sitio web de Astro simpleexamples/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
Ayudante JSON de .NETexamples/dotnet-console
Ayudante de ResourceManager de .NETexamples/dotnet-resx

Publicado bajo la licencia MIT.