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:
npx degit wsj-br/ai-i18n-tools/examples/<name> <name>
cd <name>
pnpm installPython-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.
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.txtAktivieren 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:
cd examples/dotnet-console
dotnet testdegit 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?
- Eine JS/TS-App: console-app (kleinste) oder nextjs-app. Anleitung: i18n zu einer JS/TS-App hinzufügen.
- Eine Python-App: python-streamlit, python-flask oder python-fastapi. Anleitung: i18n zu einer Python-App hinzufügen.
- Eine Django- oder GNU gettext-App: python-gettext (ein gettext-Befehlszeilentool; es gibt kein Django-Beispielverzeichnis). Anleitung: i18n zu einer Django-/Python-gettext-App hinzufügen.
- Ein .NET-Helfer: dotnet-console (
I18n.cs) oder dotnet-resx (I18nResx.csund.resx-Satelliten). Anleitungen: i18n zu einer .NET-App hinzufügen und i18n zu einer .NET ResourceManager-App hinzufügen. - Eine Website oder Dokumentationsseite: docusaurus-docs, vitepress-docs, astro-docs, nextra-docs, fumadocs-docs, astro-website, plain-html oder plain-html-docs. Anleitung: i18n zu einer Website oder Dokumentationsseite hinzufügen.
- Eine Repository-README neben einer App: console-app oder nextjs-app (das nextjs-Beispiel hat auch eine Dokumentationsseite). Anleitung: i18n zu Ihrer README und Markdown-Dokumentation hinzufügen.
- Etwas anderes: multi-provider, test-markdown und intlayer-migration.
Liste der Beispiele
| Beispiel | Am besten geeignet für | Kopieren mit degit | Ausführen |
|---|---|---|---|
| console-app | Kleinste funktionierende App mit t() UI-Strings + README-Übersetzung | npx degit wsj-br/ai-i18n-tools/examples/console-app console-app | pnpm start |
| nextjs-app | React / Next.js + Pluralformen + Dashboard; verschachtelte Docusaurus-Dokumente + flache README + SVG-Assets | npx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-app | pnpm dev (App :3030; cd docs-site && pnpm start für Dokumente :3040) |
| docusaurus-docs | Nur Docusaurus-Dokumentationsseite (docusaurus-Preset) | npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docs | pnpm start (:3100; Build + Serve, Lokalisierungsmenü funktioniert) |
| astro-website | Astro Landingpage: Vollbild-HTML + t() Hybrid | npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-website | pnpm dev |
| astro-docs | Astro Starlight Dokumentationsseite | npx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docs | pnpm dev (:3050) |
| vitepress-docs | VitePress Docs-Site + Theme JSON (pt-BR, zh-Hans) | npx degit wsj-br/ai-i18n-tools/examples/vitepress-docs vitepress-docs | pnpm run docs:dev (:3060) |
| nextra-docs | Nextra 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-docs | pnpm run dev (:3070) |
| fumadocs-docs | Fumadocs 4 MDX + meta.json / UI-Katalog (pt, zh, Dot-Parser) | npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docs | pnpm run dev (:3080) |
| plain-html | Reines HTML + data-i18n*-Marker; statisches lokales JSON (UI im Dashboard-Stil) | npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-html | pnpm dev (:3090) |
| plain-html-docs | Reines HTML als Dokumente: eine Seite pro Gebietsschema, lokalisierte Bilder, hreflang | npx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docs | pnpm dev (:3092) |
| multi-provider | LLM-Anbieter auswählen oder benchmarken (-P / --provider) | npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-provider | ai-i18n-tools translate-docs -P openai --force |
| test-markdown | Regressionstest Markdown / CJK-Übersetzung (Devanagari, MDX) | npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdown | pnpm build |
| intlayer-migration | Intlayer .content.ts → t() (migrate-intlayer, Reset + KI-Agent-Bericht) | npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migration | pnpm reset && pnpm dev (:3091) |
| intlayer-translate | Intlayer 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-translate | pnpm reset && pnpm translate (pnpm dev :3093) |
| python-streamlit | Streamlit-Dashboard, t() / _(), Quelltext-JSON | npx degit wsj-br/ai-i18n-tools/examples/python-streamlit python-streamlit | python3 -m venv .venv && pip install -r requirements.txt && streamlit run app.py |
| python-flask | Flask + Jinja, t() / _(), Quelltext-JSON | npx degit wsj-br/ai-i18n-tools/examples/python-flask python-flask | python3 -m venv .venv && pip install -r requirements.txt && flask --app app run |
| python-fastapi | FastAPI, ContextVar-Locale, t() / _(), Quelltext-JSON | npx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapi | python3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app |
| python-gettext | Bestehende GNU gettext CLI; extract / translate-ui aktualisiert .po und .mo | npx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettext | python3 app.py --lang es |
| dotnet-console | xUnit-Prüfungen von I18n.cs: eingebettetes JSON, Kultur-Fallback, {0}, Pluralformen und Configure | npx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-console | dotnet test |
| dotnet-resx | xUnit-Prüfungen von I18nResx.cs und Quellstring-.resx-Satelliten | npx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resx | dotnet 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.