Intégrations
Référence pour les intégrations de frameworks : ce qu'elles partagent et comment leurs chaînes de shell diffèrent. Pour ajouter des langues à un site, commencez par Ajouter l'i18n à un site web ou un site de documentation. Pour une application, commencez par Ajouter l'i18n à une application JS/TS, Ajouter l'i18n à une application Python, ou Ajouter l'i18n à une application .NET. Pour un fichier README de dépôt et d'autres fichiers Markdown, commencez par Ajouter l'i18n à votre README et à vos documents Markdown.
Les intégrations de documentation utilisent le pipeline Documents (translate-docs / sync) pour le contenu des pages ; les chaînes d'interface (navigation, barre latérale, thème) sont gérées dans ce même pipeline là où c'est indiqué — et non via le pipeline JSON séparé. Les applications Python utilisent le pipeline Chaînes d'interface utilisateur (extract / translate-ui).
Quel guide lire
Le tableau de sélection, avec un modèle d'initialisation par framework, se trouve dans Ajouter l'i18n à un site web ou un site de documentation. L'invite de procédure guidée sur cette page active l'i18n du framework. Les pages d'intégration ci-dessous conservent les détails du catalogue shell. Frameworks Python : Python.
Concepts partagés
Les intégrations de frameworks 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 du dossier de sortie et le comportement de réécriture des liens, consultez Output layouts et Link rewriting. La configuration Python est distincte : Python.
Chaque init -t ui-* -P <provider> scaffold écrit le bloc de fournisseur LLM de ce préréglage. Avant translate-docs ou sync, définissez la clé API correspondante — consultez 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 |
| Streamlit | examples/python-streamlit |
| Flask | examples/python-flask |
| FastAPI | examples/python-fastapi |
| GNU gettext | examples/python-gettext |
| Helper JSON .NET | exemples/dotnet-console |
| Helper ResourceManager .NET | exemples/dotnet-resx |