Integraciones
Guías específicas de cada framework para integrar ai-i18n-tools en sitios de documentación y proyectos Astro. Cada integración utiliza la canalización Documentos (translate-docs / sync) para el contenido de la página; las cadenas de shell (navegación, barra lateral, tema) se manejan dentro de esa misma canalización cuando se indica, no a través de la canalización JSON separada.
Qué guía leer
| Su sitio | Plantilla de inicio | Empiece aquí |
|---|---|---|
| Astro Starlight o Astro simple | Cadenas de UI ui-starlight / híbridas | Astro |
| Docusaurus | ui-docusaurus | Docusaurus |
| VitePress | ui-vitepress | VitePress |
| Nextra 4 (Next.js App Router) | ui-nextra | Nextra |
| Fumadocs 4 (Next.js App Router) | ui-fumadocs | Fumadocs |
Conceptos compartidos
Todas las integraciones de frameworks de documentación comparten el mismo modelo de bloque docs[] descrito en Documentos. Establezca docsOutput.style para que coincida con su framework ("docusaurus", "vitepress", "nextra", "fumadocs" o "astro-starlight"). Para el diseño de la carpeta de salida y el comportamiento de reescritura de enlaces, consulte Diseños de salida y Reescritura de enlaces.
Cada plantilla init -t ui-* genera un bloque de proveedor de LLM predeterminado (openrouter a menos que pase -P <provider>). Antes de translate-docs o sync, configure provider / providers si es necesario y establezca la clave API correspondiente; consulte Proveedor y clave 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 |