Was ist ai-i18n-tools?
Sie haben eine App, eine Website, eine Dokumentationsseite oder eine Repository-README in einer Sprache und möchten diese in weiteren Sprachen anbieten. Diese Sprache ist sourceLocale und es kann eine beliebige Sprache sein. Englisch ist ein gängiges Beispiel in diesen Anleitungen. ai-i18n-tools findet den Text, übersetzt ihn mit den Modellen des von Ihnen gewählten LLM-Anbieters und schreibt die Dateien, die Ihr Projekt bereits lädt. Es cacht jedes Ergebnis, sodass bei erneuten Ausführungen nur neuer oder geänderter Text an das Modell gesendet wird.
Was Sie tun und was das Tool tut
| Sie | Das Tool |
|---|---|
| Wählen Sie die Sprachen, einen Anbieter und die auszuprobierenden Modelle aus | Extrahiert Text, übersetzt ihn, validiert das Ergebnis und schreibt Kataloge oder Seiten |
Machen Sie benutzerorientierten Text für das Tool sichtbar: t()-Aufrufe im App-Code, die eigene i18n Ihres Frameworks für eine Website oder eine Sprachlisten-Markierung in einer README | Speichert Übersetzungen im Cache und verwendet sie bei jeder erneuten Ausführung wieder |
| Verbinden Sie das Ergebnis mit der App, dem Routing der Website oder der Sprachzeile der README-Datei | Zeigt den Fortschritt an und ermöglicht Ihnen die Überprüfung von Übersetzungen im Dashboard |
Das Tool schreibt Ihren Quellcode nicht um, es sei denn, Sie führen migrate-python-i18n oder migrate-dotnet-i18n mit --write aus. Eingabeaufforderungen des Coding-Agents werden für den Wrapping-Schritt bereitgestellt. Es installiert weder i18next noch die i18n Ihres Site-Frameworks und erstellt auch keinen Sprachwechsler, obwohl Laufzeit-Helfer dafür bereitgestellt werden.
Wo fange ich an?
Die Anleitungen sind unter i18n zu Ihrem Projekt hinzufügen gruppiert, mit der gemeinsamen Einrichtung und einer Seite für jede Art von Projekt. Wählen Sie eine Zeile aus:
| Sie haben | Beginnen Sie hier |
|---|---|
| Eine JS/TS-App (React, Next.js, Node, CLI) mit Klartext im Quellcode | i18n zu einer JS/TS-App hinzufügen |
| Eine Python-App (Streamlit, FastAPI, Flask, Desktop, Skripte) | i18n zu einer Python-App hinzufügen |
| Eine .NET-App (Avalonia, WPF, MAUI, ASP.NET, Blazor, Konsole) | i18n zu einer .NET-App hinzufügen |
Eine .NET-App, die bereits ResourceManager oder IStringLocalizer verwendet | i18n zu einer .NET ResourceManager-App hinzufügen |
| Eine Django-App, Flask-Babel-Kataloge oder eine App, die bereits GNU gettext verwendet | i18n zu einer Django-/Python-gettext-App hinzufügen |
| Eine Website oder Dokumentationsseite (VitePress, Docusaurus, Starlight, Nextra, Fumadocs, Astro, reines HTML) | i18n zu einer Website oder Dokumentationsseite hinzufügen |
| Eine Repository-README und andere Markdown-Dateien, normalerweise neben einer App | i18n zu Ihrer README und Markdown-Dokumentation hinzufügen |
| Eigenständige verschachtelte JSON-Lokalisierungsdateien | JSON |
| SVG-Diagramme mit Textbeschriftungen | SVG-Übersetzung |
| Intlayer-Wörterbücher (von Intlayer migrieren) | Migration von Intlayer |
| Intlayer-Wörterbücher (Intlayer beibehalten, direkt übersetzen) | Intlayer direkt übersetzen |
So funktioniert's
- Installieren Sie die CLI und legen Sie den API-Schlüssel Ihres Anbieters fest: Installation.
- Führen Sie
initaus, umai-i18n-tools.config.jsonzu schreiben: Schnellstart. - Bereiten Sie das Projekt vor: Umschließen Sie Zeichenfolgen in
t(), aktivieren Sie die i18n Ihres Site-Frameworks oder fügen Sie die Sprachlisten-Markierung zu einer README hinzu. - Führen Sie
syncaus. Es extrahiert Text, übersetzt Neues und schreibt die Ausgabe. - Laden Sie die Ausgabe in Ihre App oder Website, fügen Sie einen Sprachumschalter hinzu und führen Sie
syncerneut aus, wenn sich der Quellcode ändert.
Übersetzungsmodi
Unter der Haube führt das Tool vier Pipelines aus. Ihre Konfiguration aktiviert die benötigten, und sync führt sie der Reihe nach aus.
- UI-Strings — Extrahieren Sie
t("…")- und_()-Aufrufe aus JS/TS und Python sowieT("…")/{loc:Tr '…'}aus C# und XAML (einschließlich GNU gettext und .NET.resx-Satelliten) und schreiben Sie flaches, pro-Locale-JSON,.po/.mooder.resx. Befehle:extract,translate-ui,migrate-dotnet-i18n. Anleitung: UI-Strings. Python: Python-Anwendungen. .NET: .NET-Anwendungen und i18n zu einer .NET ResourceManager-App hinzufügen. - Dokumente — Übersetzen Sie Markdown-, MDX- und
.astro-Seiten, die indocs[].contentPathsaufgeführt sind. Funktioniert mit VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro und anderen statischen Dokumentations-Sites sowie mit einem Repository-README (docsOutput.stylevonflat). Befehl:translate-docs. Anleitungen: Dokumente und i18n zu Ihrem README und Ihren Markdown-Dokumenten hinzufügen. - JSON — Übersetzen Sie verschachtelte JSON-Locale-Bundles (Themenbezeichnungen, i18n-Überschreibungen, App-Text, der nicht im Quellcode enthalten ist), die in Top-Level
json[]definiert sind. Befehl:translate-json. Anleitung: JSON. - SVG — Übersetzen Sie sichtbaren Text innerhalb von SVG-Illustrationen (
<text>,<title>,<desc>) und schreiben Sie eine Ausgabedatei pro Locale. Getrennt von der Dokumentenübersetzung. Befehl:translate-svg. Anleitung: SVG-Übersetzung.
Viele Projekte kombinieren Modi. Die häufigste Kombination sind UI-Strings und die Repository-README. Eine Dokumentationsseite wie VitePress ist die andere häufige Kombination. Siehe Pipelines kombinieren und i18n zu Ihrer README und Markdown-Dokumentation hinzufügen.
Beispiele
Das Repository enthält ausführbare Beispielprojekte unter examples/, jedes mit eigener Konfiguration, committeten Lokalisierungsausgaben und README. Übersetzte Dateien können ohne API-Schlüssel erkundet werden; für eine erneute Ausführung der Übersetzung ist ein Anbieter-Schlüssel erforderlich.
| Wenn Sie haben | Beispiel |
|---|---|
| Eine JS/TS-App | console-app, nextjs-app |
| Eine Repository-README neben einer App | console-app, nextjs-app |
| Eine Python-App | python-streamlit, python-fastapi, python-gettext |
| Ein .NET-Helfer | dotnet-console, dotnet-resx |
| Eine Dokumentationsseite | docusaurus-docs, vitepress-docs, astro-docs |
| Eine Website oder reines HTML | astro-website, plain-html |
Die vollständige Liste und npx degit Kopierbefehle finden Sie unter Beispiele.
Nächste Schritte
- Installation – Installieren Sie das npm-Paket oder laden Sie die eigenständige ausführbare Datei für ein Python-Projekt herunter und legen Sie Ihren Provider-API-Schlüssel fest.
- Schnellstart – Erstellen Sie eine Konfigurationsvorlage und führen Sie Ihre erste Übersetzung aus.
- LLM-Provider – Wählen Sie einen Provider, einen API-Schlüssel und eine
-P-Überschreibung. - KI-Modelle – Erstellen Sie mit
suggest-modelsoder über den Tab Modelle im Dashboard eine Rangfolge für eine Auswahlliste und behalten Sie mehrere Modelle bei, sodass bei einer fehlgeschlagenen Übersetzung das nächste Modell ausprobiert werden kann.