Skip to content

Beispiele ​

Ausführbare Projekte unter examples/ auf GitHub – jedes mit eigener Konfiguration, festgeschriebenen Gebietsschema-Ausgaben und README. Sie können übersetzte Dateien ohne API-Schlüssel erkunden; für eine erneute Übersetzung ist ein Anbieterschlüssel erforderlich (Anbieter und Modelle).

Eigenständig ausführen (npx degit) ​

Kopieren Sie ein einzelnes Beispiel, ohne das vollständige Repository zu klonen.

Node.js-Beispiele ​

Jedes Node.js-Beispiel deklariert einen veröffentlichten Caret-Bereich von ai-i18n-tools, der der aktuellen Paketversion entspricht, und installiert die CLI über npm:

bash
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm install

Python-Beispiele ​

python-streamlit, python-flask, python-fastapi und python-gettext haben kein package.json. Die degit-Befehle in der Tabelle unten sind gültig. Sie können auch ai-i18n-tools-python-examples.zip von den GitHub Release herunterladen. Diese Zip-Datei enthält dieselben vier Verzeichnisse. Sie ist nicht Teil des npm-Pakets und nicht in der eigenständigen ausführbaren Datei enthalten.

python-streamlit, python-flask und python-fastapi verwenden ein virtualenv und pip install -r requirements.txt. python-gettext verwendet nur die Standardbibliothek. Übersetzen Sie mit der eigenständigen ausführbaren Datei.

bash
npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit
cd python-streamlit
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Aktivieren Sie unter Windows .venv\Scripts\activate.

Wenn Sie stattdessen das gesamte ai-i18n-tools-Repository geklont haben, führen Sie pnpm install und pnpm run build im Repository-Stammverzeichnis aus, dann cd examples/<name>. Workspace (Node.js)-Beispiele verwenden die lokale CLI über ihre pnpm run i18n:*-Skripte oder direkt ai-i18n-tools … nach der PATH-Einrichtung. Python-Beispiele in diesem Checkout übersetzen mit node ../../bin/ai-i18n-tools.mjs nach dem Build. Siehe Installation — Geklontes Monorepo.

.NET-Beispiele ​

dotnet-console und dotnet-resx haben keine package.json. Die degit-Befehle in der folgenden Tabelle sind gültig. Sie können ai-i18n-tools-dotnet-examples.zip auch vom GitHub-Release herunterladen. Dieses Zip-Archiv enthält dieselben zwei Verzeichnisse und assets/dotnet, die die Projekte über ../../assets/dotnet kompilieren. Es ist nicht Teil des npm-Pakets und nicht im eigenständigen ausführbaren Programm enthalten. Vor diesem Zip-Archiv veröffentlichte Releases enthalten es nicht.

Beide sind xUnit-Projekte. dotnet-console prüft I18n.cs. dotnet-resx prüft I18nResx.cs und .resx-Satelliten. Keines ruft eine Übersetzungs-API auf. Führen Sie dotnet test im Verzeichnis aus. Von einem vollständigen Klon aus führt pnpm test:dotnet im Repository-Stammverzeichnis beide aus und überspringt sie, wenn dotnet nicht auf PATH ist.

Entpacken Sie ai-i18n-tools-dotnet-examples.zip, und führen Sie dann die Prüfungen aus dem Beispielverzeichnis aus. Das Archiv hält examples/ und assets/dotnet nebeneinander, was der Pfad ist, den die Projekte kompilieren:

bash
cd examples/dotnet-console
dotnet test

degit kopiert ein Verzeichnis und enthält assets/dotnet nicht. Diese Kompilierungslinks werden in einem vollständigen Klon oder nach dem Entpacken des Zips aufgelöst.

Welches Beispiel passt zu meinem Projekt? ​

Liste der Beispiele ​

BeispielAm besten geeignet fürKopieren mit degitAusführen
console-appKleinste funktionierende App mit t() UI-Strings + README-Übersetzungnpx degit wsj-br/ai-i18n-tools/examples/console-app console-apppnpm start
nextjs-appReact / Next.js + Pluralformen + Dashboard; verschachtelte Docusaurus-Dokumente + flache README + SVG-Assetsnpx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-apppnpm dev (App :3030; cd docs-site && pnpm start für Dokumente :3040)
docusaurus-docsNur Docusaurus-Dokumentationsseite (docusaurus-Preset)npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docspnpm start (:3100; Build + Serve, Lokalisierungsmenü funktioniert)
astro-websiteAstro Landingpage: Vollbild-HTML + t() Hybridnpx degit wsj-br/ai-i18n-tools/examples/astro-website astro-websitepnpm dev
astro-docsAstro Starlight Dokumentationsseitenpx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docspnpm dev (:3050)
vitepress-docsVitePress Docs-Site + Theme JSON (pt-BR, zh-Hans)npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docspnpm run docs:dev (:3060)
nextra-docsNextra 4 MDX + _meta.ts / Wörterbuch-.ts-Shell, plus einer t()-Serverkomponente (pt-BR, zh-Hans)npx degit wsj-br/ai-i18n-tools/examples/nextra-docs nextra-docspnpm run dev (:3070)
fumadocs-docsFumadocs 4 MDX + meta.json / UI-Katalog (pt, zh, Dot-Parser)npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docspnpm run dev (:3080)
plain-htmlReines HTML + data-i18n*-Marker; statisches lokales JSON (UI im Dashboard-Stil)npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-htmlpnpm dev (:3090)
plain-html-docsReines HTML als Dokumente: eine Seite pro Gebietsschema, lokalisierte Bilder, hreflangnpx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docspnpm dev (:3092)
multi-providerLLM-Anbieter auswählen oder benchmarken (-P / --provider)npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-providerai-i18n-tools translate-docs -P openai --force
test-markdownRegressionstest Markdown / CJK-Übersetzung (Devanagari, MDX)npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdownpnpm build
intlayer-migrationIntlayer .content.ts → t() (migrate-intlayer, Reset + KI-Agent-Bericht)npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migrationpnpm reset && pnpm dev (:3091)
intlayer-translateIntlayer beibehalten, fehlende Lokalisierungen vor Ort ergänzen (translate-intlayer; en + pt-BR geliefert, es + zh-Hans fehlend)npx degit wsj-br/ai-i18n-tools/examples/intlayer-translate intlayer-translatepnpm reset && pnpm translate (pnpm dev :3093)
python-streamlitStreamlit-Dashboard, t() / _(), Quelltext-JSONnpx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlitpython3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py
python-flaskFlask + Jinja, t() / _(), Quelltext-JSONnpx degit wsj-br/ai-i18n-tools/examples/python-flask python-flaskpython3 -m venv .venv && pip install -r requirements.txt && flask --app app run
python-fastapiFastAPI, ContextVar-Locale, t() / _(), Quelltext-JSONnpx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapipython3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app
python-gettextBestehende GNU gettext CLI; extract / translate-ui aktualisiert .po und .monpx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettextpython3 app.py --lang es
dotnet-consolexUnit-Prüfungen von I18n.cs: eingebettetes JSON, Kultur-Fallback, {0}, Pluralformen und Configurenpx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-consoledotnet test
dotnet-resxxUnit-Prüfungen von I18nResx.cs und Quellstring-.resx-Satellitennpx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resxdotnet test

Jeder Beispiel-Name verlinkt zu seinem GitHub-README mit vollständiger Einrichtung, Befehlen und Projektlayout – oder durchsuchen Sie den Beispielindex im Repository.

Node.js-Beispiele installieren die CLI von npm nach pnpm install. Die vier Python-Beispiele verwenden venv und pip (python-gettext verwendet nur die Standardbibliothek) und das eigenständige ausführbare Programm zur Übersetzung. Die beiden .NET-Beispiele sind xUnit-Projekte. Führen Sie sie mit dotnet test aus. Sie befinden sich auch in ai-i18n-tools-dotnet-examples.zip im GitHub-Release.


Haftungsausschluss

Produktnamen und Icons sind Eigentum ihrer jeweiligen Inhaber und dienen ausschließlich zu Identifikationszwecken. Diese Software steht in keiner Verbindung zu diesen Marken und wird auch nicht von ihnen unterstützt.

Veröffentlicht unter der MIT-Lizenz.