Integrationen
Framework-spezifische Anleitungen zum Einbinden von ai-i18n-tools in Dokumentationsseiten und Astro-Projekte. Jede Integration verwendet die Dokumente-Pipeline (translate-docs / sync) für Seiteninhalte; Shell-Strings (Navigation, Seitenleiste, Theme) werden, wo angegeben, innerhalb derselben Pipeline behandelt – nicht über die separate JSON-Pipeline.
Welchen Leitfaden Sie lesen sollten
| Ihre Website | Init-Vorlage | Hier starten |
|---|---|---|
| Astro Starlight oder reines Astro | ui-starlight / hybride UI-Strings | 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 |
Gemeinsame Konzepte
Alle Dokumentations-Framework-Integrationen teilen dasselbe docs[]-Blockmodell, das unter Dokumente 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 der Link-Umschreibung finden Sie unter Ausgabe-Layouts und Link-Umschreibung.
Jede init -t ui-*-Vorlage erstellt einen Standard-LLM-Anbieterblock (openrouter, es sei denn, Sie übergeben -P <provider>). Bevor Sie translate-docs oder sync verwenden, konfigurieren Sie bei Bedarf provider / providers und legen Sie den passenden 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 |