Integrationen
Referenz für die Framework-Integrationen: was sie gemeinsam haben und wie sich ihre Shell-Strings unterscheiden. Um Sprachen zu einer Website hinzuzufügen, beginnen Sie bei i18n zu einer Website oder Dokumentationsseite hinzufügen. Für eine Anwendung beginnen Sie bei i18n zu einer JS/TS-Anwendung hinzufügen, i18n zu einer Python-Anwendung hinzufügen oder i18n zu einer .NET-Anwendung hinzufügen. Für ein Repository-README und andere Markdown-Dateien beginnen Sie bei i18n zu Ihrem README und Ihren Markdown-Dokumenten hinzufügen.
Dokumentations-Integrationen verwenden die Dokumente-Pipeline (translate-docs / sync) für Seiteninhalte; Shell-Strings (Navigation, Seitenleiste, Theme) werden, wo vermerkt, innerhalb derselben Pipeline behandelt – nicht über die separate JSON-Pipeline. Python-Anwendungen verwenden die UI-Strings-Pipeline (extract / translate-ui).
Welchen Leitfaden Sie lesen sollten
Die Auswahltabelle mit einer Initialisierungsvorlage pro Framework finden Sie unter i18n zu einer Website oder Dokumentationsseite hinzufügen. Die Aufforderung zur exemplarischen Vorgehensweise auf dieser Seite aktiviert die i18n des Frameworks. Die folgenden Integrationsseiten enthalten die Details zum Shell-Katalog. Python-Frameworks: Python.
Gemeinsame Konzepte
Integrationen für Dokumentations-Frameworks nutzen dasselbe docs[]-Blockmodell, das unter Documents beschrieben ist. Setzen Sie docsOutput.style passend zu Ihrem Framework ("docusaurus", "vitepress", "nextra", "fumadocs" oder "astro-starlight"). Informationen zum Layout des Ausgabeordners und zum Verhalten beim Umschreiben von Links finden Sie unter Output layouts und Link rewriting. Die Python-Einrichtung erfolgt separat: Python.
Jedes init -t ui-* -P <provider> Scaffold schreibt den LLM-Provider-Block dieses Presets. Vor translate-docs oder sync legen Sie den entsprechenden API-Schlüssel fest – siehe Anbieter und API-Schlüssel.
Einen frameworkübergreifenden Vergleich finden Sie unter Framework-Shell-Übersetzung. Jede der unten verlinkten Anleitungen behandelt die Einrichtung für das jeweilige Framework.
Übersetzung der Framework-Shell
| Framework | Shell / Theme-Strings | Pipeline |
|---|---|---|
| Docusaurus | write-translations-Katalog ({ message, description }) | Dokumente — docs[].docusaurusCatalogDir + translate-docs |
| VitePress | Theme-/Navigations-/Seitenleisten-Katalog | Dokumente — docsOutput.vitepressThemeCatalog + translate-docs |
| Nextra | _meta.ts-Seitenleistenbeschriftungen | Dokumente — automatisch, wenn style: "nextra" + translate-docs |
| Nextra | Theme-Wörterbuch .ts | Dokumente — docs[].nextraDictionaryPath + translate-docs |
| Fumadocs | meta.json-Seitenleistenbeschriftungen | Dokumente — automatisch, wenn style: "fumadocs" + translate-docs |
| Fumadocs | UI-Überschreibungs-Katalog | Dokumente — docsOutput.fumadocsUiCatalog + translate-docs |
| Astro Starlight | Eingebaute UI-Strings (viele Gebietsschemata); keine zusätzliche Shell-Pipeline | Dokumente — translate-docs (nur Seiten) |
Legen Sie keine Framework-Shell-/Theme-Strings in json[] ab – diese Pipeline ist für nicht verwandte App-Locale-Bundles vorgesehen. Details zur Einrichtung pro Framework finden Sie in den Anleitungen, die unter Welche Anleitung soll ich lesen? verlinkt sind.
Ausführbare Beispiele
| Framework | Beispiel-Repo |
|---|---|
| Astro Starlight | examples/astro-docs |
| Reine Astro-Website | 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 |
| .NET JSON-Helfer | examples/dotnet-console |
| .NET ResourceManager-Helfer | examples/dotnet-resx |