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
| Framework | Cadenas de shell / tema | Pipeline |
|---|---|---|
| Docusaurus | Catálogo write-translations ({ message, description }) | Documentos — docs[].docusaurusCatalogDir + translate-docs |
| VitePress | Catálogo de tema/navegación/barra lateral | Documentos — docsOutput.vitepressThemeCatalog + translate-docs |
| Nextra | Etiquetas de barra lateral _meta.ts | Documentos — automático cuando style: "nextra" + translate-docs |
| Nextra | Diccionario de tema .ts | Documentos — docs[].nextraDictionaryPath + translate-docs |
| Fumadocs | Etiquetas de barra lateral meta.json | Documentos — automático cuando style: "fumadocs" + translate-docs |
| Fumadocs | Catálogo de anulaciones de UI | Documentos — docsOutput.fumadocsUiCatalog + translate-docs |
| Astro Starlight | Cadenas de UI integradas (muchas configuraciones regionales); sin pipeline de shell adicional | Documentos — 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
| Framework | Repositorio de ejemplo |
|---|---|
| Astro Starlight | examples/astro-docs |
| Sitio web de Astro simple | 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 |
| Ayudante JSON de .NET | examples/dotnet-console |
| Ayudante de ResourceManager de .NET | examples/dotnet-resx |