Skip to content

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 ​

FrameworkChaînes de shell / thèmePipeline
DocusaurusCatalogue write-translations ({ message, description })Documents — docs[].docusaurusCatalogDir + translate-docs
VitePressCatalogue Thème/nav/barre latéraleDocuments — docsOutput.vitepressThemeCatalog + translate-docs
NextraÉtiquettes de barre latérale _meta.tsDocuments — auto quand style: "nextra" + translate-docs
NextraDictionnaire de thème .tsDocuments — docs[].nextraDictionaryPath + translate-docs
FumadocsÉtiquettes de barre latérale meta.jsonDocuments — auto quand style: "fumadocs" + translate-docs
FumadocsCatalogue de surcharges d'interface utilisateurDocuments — docsOutput.fumadocsUiCatalog + translate-docs
Astro StarlightChaînes d'interface utilisateur intégrées (nombreuses locales) ; pas de pipeline de shell supplémentaireDocuments — 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 ​

FrameworkDépôt d'exemple
Astro Starlightexamples/astro-docs
Site web 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
Helper JSON .NETexemples/dotnet-console
Helper ResourceManager .NETexemples/dotnet-resx

Publié sous licence MIT.