i18n zu Ihrem Projekt hinzufügen

Dieser Abschnitt enthält die Anleitungen für ein Projekt, das derzeit nur eine Sprache spricht. Beginnen Sie hier. Jede der folgenden Seiten führt Sie für eine bestimmte Projektart von der Einrichtung bis zu den ersten übersetzten Dateien. Erste Schritte behandelt, was das Tool ist, die Installationsoptionen sowie Anbieter und Modelle. Sie können direkt mit einer Anleitung beginnen, ohne diese Seiten vorher zu lesen.

Was Sie tun und was das Tool tut

Sie	Das Tool
Wählen Sie die Sprachen, einen Anbieter und die Modelle zum Ausprobieren aus	Extrahiert Text, übersetzt ihn, prüft das Ergebnis und schreibt Kataloge oder Seiten
Text sichtbar machen: t() im App-Code, die i18n-Funktion Ihres Site-Frameworks oder einen Sprachlisten-Marker in einer README-Datei	Speichert jede Übersetzung im Cache und verwendet sie beim nächsten Durchlauf wieder
Dateien laden und eine Sprache prüfen	Zeigt den Fortschritt an und ermöglicht Ihnen die Überprüfung der Formulierungen im Übersetzungs-Dashboard

Die Anleitungen geben an, welche Quelltextänderungen Sie vornehmen müssen. Hinweise für Coding-Agenten sind enthalten, wo diese Änderungen mechanischer Natur sind. Die CLI schreibt die Kataloge und die übersetzten Dateien. Sie installiert weder i18next noch die i18n-Funktion Ihres Site-Frameworks.

Gemeinsame Einrichtung

Jede Anleitung folgt der gleichen Reihenfolge. Die von Ihnen gewählte Seite ergänzt die Details.

1. Installieren Sie die CLI und legen Sie den API-Schlüssel Ihres Anbieters fest. Ollama benötigt keinen Schlüssel. Installation und Anbieter und API-Schlüssel.
2. Führen Sie init mit der Vorlage aus, die auf der Seite genannt wird. Dies schreibt ai-i18n-tools.config.json.
3. Bereiten Sie das Projekt vor, damit das Tool den Text sehen kann.
4. Führen Sie ai-i18n-tools sync und dann ai-i18n-tools status aus.
5. Laden Sie die Ausgabe, prüfen Sie eine Zielsprache und führen Sie sync erneut aus, wenn sich die Quelle ändert. Der Cache sendet nur neuen oder geänderten Text an das Modell.

Seiten in diesem Abschnitt

Sie haben	Seite	Was diese Seite behandelt
Eine JS/TS-App (React, Next.js, Node, CLI), deren Schaltflächen und Nachrichten noch als Klartext vorliegen	i18n zu einer JS/TS-App hinzufügen	i18next installieren, den Bootstrap hinzufügen, Literale in t() einschließen, dann extract und translate-ui
Eine Python-App (Streamlit, FastAPI, Flask, Django, gettext)	i18n zu einer Python-App hinzufügen	t() oder _() einschließen oder GNU gettext beibehalten. Die CLI kann als eigenständige ausführbare Datei ohne Node.js-Installation ausgeführt werden
Eine Dokumentations- oder Marketing-Website (VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro, reines HTML)	i18n zu einer Website oder Dokumentations-Website hinzufügen	Aktivieren Sie die eigenen Sprachrouten des Frameworks, übersetzen Sie dann Seiten und Theme-Labels
Eine Repository-README-Datei und andere Markdown-Dateien, normalerweise neben einer App	i18n zu Ihrer README-Datei und Markdown-Dokumentation hinzufügen	Eine Datei pro Sprache (translated-docs/README.de.md) und eine Sprachzeile in der README-Datei. init --with-readme fügt diesen Block zu jeder Vorlage hinzu
Mehrere der oben genannten Elemente in einem Repository	Pipelines kombinieren	Eine Konfiguration und ein sync. Das übliche Paar sind App-UI-Strings plus die README-Datei
Intlayer-Wörterbücher, und Sie möchten Intlayer beibehalten	Intlayer vor Ort übersetzen	translate-intlayer füllt fehlende und veraltete Blätter innerhalb von *.content.ts
Intlayer-Wörterbücher, und Sie wechseln von Intlayer ab	Migration von Intlayer	migrate-intlayer füllt Kataloge aus den Wörterbüchern und schreibt sichere Aufrufstellen in t() um

Eine App, die auch eine README-Datei hat, verwendet die App-Seite und die README-Seite zusammen. Eine Website, die auch eine README-Datei hat, verwendet die Website-Seite und init … --with-readme für den README-Block.

Wo Sie tiefer einsteigen können

Die Anleitungen enden, sobald die erste Sprache eingerichtet ist. Die Referenzseiten setzen dort an:

• UI-Strings, Dokumente, JSON und SVG für jeweils eine Pipeline.
• Integrationen für Framework-Shell-Strings (Navigation, Seitenleiste, Design).
• Schnellstart für die Befehlsliste und empfohlene package.json-Skripte.
• LLM-Anbieter für Voreinstellungen und API-Schlüssel.
• KI-Modelle für die Rangliste der engeren Auswahl und die Fallback-Kette.