Skip to content

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 ​

SieDas Tool
Wählen Sie die Sprachen, einen Anbieter und die auszuprobierenden Modelle ausExtrahiert 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 READMESpeichert Ü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-DateiZeigt 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 habenBeginnen Sie hier
Eine JS/TS-App (React, Next.js, Node, CLI) mit Klartext im Quellcodei18n 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 verwendeti18n zu einer .NET ResourceManager-App hinzufügen
Eine Django-App, Flask-Babel-Kataloge oder eine App, die bereits GNU gettext verwendeti18n 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 Appi18n zu Ihrer README und Markdown-Dokumentation hinzufügen
Eigenständige verschachtelte JSON-LokalisierungsdateienJSON
SVG-Diagramme mit TextbeschriftungenSVG-Ü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 ​

  1. Installieren Sie die CLI und legen Sie den API-Schlüssel Ihres Anbieters fest: Installation.
  2. Führen Sie init aus, um ai-i18n-tools.config.json zu schreiben: Schnellstart.
  3. 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.
  4. Führen Sie sync aus. Es extrahiert Text, übersetzt Neues und schreibt die Ausgabe.
  5. Laden Sie die Ausgabe in Ihre App oder Website, fügen Sie einen Sprachumschalter hinzu und führen Sie sync erneut 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 sowie T("…") / {loc:Tr '…'} aus C# und XAML (einschließlich GNU gettext und .NET .resx-Satelliten) und schreiben Sie flaches, pro-Locale-JSON, .po / .mo oder .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 in docs[].contentPaths aufgeführt sind. Funktioniert mit VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro und anderen statischen Dokumentations-Sites sowie mit einem Repository-README (docsOutput.style von flat). 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 habenBeispiel
Eine JS/TS-Appconsole-app, nextjs-app
Eine Repository-README neben einer Appconsole-app, nextjs-app
Eine Python-Apppython-streamlit, python-fastapi, python-gettext
Ein .NET-Helferdotnet-console, dotnet-resx
Eine Dokumentationsseitedocusaurus-docs, vitepress-docs, astro-docs
Eine Website oder reines HTMLastro-website, plain-html

Die vollständige Liste und npx degit Kopierbefehle finden Sie unter Beispiele.

Nächste Schritte ​

  1. 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.
  2. Schnellstart – Erstellen Sie eine Konfigurationsvorlage und führen Sie Ihre erste Übersetzung aus.
  3. LLM-Provider – Wählen Sie einen Provider, einen API-Schlüssel und eine -P-Überschreibung.
  4. KI-Modelle – Erstellen Sie mit suggest-models oder ü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.

Veröffentlicht unter der MIT-Lizenz.