Intégrations
Guides spécifiques au framework pour intégrer les outils ai-i18n dans les sites de documentation et les projets Astro. Chaque intégration utilise le pipeline Documents (translate-docs / sync) pour le contenu des pages ; les chaînes de shell (navigation, barre latérale, thème) sont gérées dans ce même pipeline, le cas échéant — et non via le pipeline JSON séparé.
Quel guide lire
| Votre site | Modèle d'initialisation | Commencer ici |
|---|---|---|
| Astro Starlight ou Astro simple | ui-starlight / chaînes d'interface utilisateur hybrides | 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 |
Concepts partagés
Toutes les intégrations de framework de documentation partagent le même modèle de bloc docs[] décrit dans Documents. Définissez docsOutput.style pour correspondre à votre framework ("docusaurus", "vitepress", "nextra", "fumadocs" ou "astro-starlight"). Pour la disposition des dossiers de sortie et le comportement de réécriture des liens, consultez Dispositions de sortie et Réécriture des liens.
Chaque modèle init -t ui-* génère un bloc de fournisseur LLM par défaut (openrouter sauf si vous passez -P <provider>). Avant translate-docs ou sync, configurez provider / providers si nécessaire et définissez la clé API correspondante — voir Fournisseur et clé API.
Voir Traduction du shell du framework pour une comparaison entre les frameworks. Chaque guide lié ci-dessous couvre la configuration de ce framework.
Traduction du shell du framework
| Framework | Chaînes de shell / thème | Pipeline |
|---|---|---|
| Docusaurus | Catalogue write-translations ({ message, description }) | Documents — docs[].docusaurusCatalogDir + translate-docs |
| VitePress | Catalogue Thème/nav/barre latérale | Documents — docsOutput.vitepressThemeCatalog + translate-docs |
| Nextra | Étiquettes de barre latérale _meta.ts | Documents — auto quand style: "nextra" + translate-docs |
| Nextra | Dictionnaire de thème .ts | Documents — docs[].nextraDictionaryPath + translate-docs |
| Fumadocs | Étiquettes de barre latérale meta.json | Documents — auto quand style: "fumadocs" + translate-docs |
| Fumadocs | Catalogue de surcharges d'interface utilisateur | Documents — docsOutput.fumadocsUiCatalog + translate-docs |
| Astro Starlight | Chaînes d'interface utilisateur intégrées (nombreuses locales) ; pas de pipeline de shell supplémentaire | Documents — translate-docs (pages uniquement) |
Ne placez pas les chaînes de shell/thème du framework dans json[] — ce pipeline est destiné aux bundles de paramètres régionaux d'applications non liés. Les détails de configuration par framework se trouvent dans les guides liés à partir de Quel guide lire.
Exemples exécutables
| Framework | Dépôt d'exemple |
|---|---|
| Astro Starlight | examples/astro-docs |
| Site web Astro simple | examples/astro-website |
| Docusaurus | examples/docusaurus-docs |
| VitePress | examples/vitepress-docs |
| Nextra | examples/nextra-docs |
| Fumadocs | examples/fumadocs-docs |