Skip to content

Exemples ​

Projets exécutables sous examples/ sur GitHub — chacun avec sa propre configuration, ses sorties de paramètres régionaux validées et son fichier README. Vous pouvez explorer les fichiers traduits sans clé API ; la réexécution de la traduction nécessite une clé de fournisseur (Fournisseurs et modèles).

Exécuter de manière autonome (npx degit) ​

Copiez un exemple sans cloner l'intégralité du dépôt.

Exemples Node.js ​

Chaque exemple Node.js déclare une plage de versions caret ai-i18n-tools correspondant à la version actuelle du paquet et installe l'interface de ligne de commande (CLI) depuis npm :

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

Exemples Python ​

python-streamlit, python-flask, python-fastapi et python-gettext n'ont pas de package.json. Les commandes degit dans le tableau ci-dessous sont valides. Vous pouvez également télécharger ai-i18n-tools-python-examples.zip depuis la GitHub Release. Ce fichier zip contient les quatre mêmes répertoires. Il ne fait pas partie du paquet npm et ne se trouve pas à l'intérieur de l'exécutable autonome.

python-streamlit, python-flask et python-fastapi utilisent un virtualenv et pip install -r requirements.txt. python-gettext utilise uniquement la bibliothèque standard. Traduisez avec l'exécutable autonome.

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

Sous Windows, activez .venv\Scripts\activate.

Si vous avez cloné l'intégralité du dépôt ai-i18n-tools, exécutez pnpm install et pnpm run build à la racine du dépôt, puis cd examples/<name>. Les exemples d'espace de travail (Node.js) utilisent la CLI locale via leurs scripts pnpm run i18n:*, ou ai-i18n-tools … directement après la configuration du PATH. Les exemples Python dans ce checkout se traduisent avec node ../../bin/ai-i18n-tools.mjs après la compilation. Voir Installation — Dépôt cloné.

Exemples .NET ​

dotnet-console et dotnet-resx n'ont pas de package.json. Les commandes degit du tableau ci-dessous sont valides. Vous pouvez également télécharger ai-i18n-tools-dotnet-examples.zip depuis la version GitHub. Ce fichier zip contient les deux mêmes répertoires et assets/dotnet, que les projets compilent via ../../assets/dotnet. Il ne fait pas partie du package npm et n'est pas inclus dans l'exécutable autonome. Les versions publiées avant ce fichier zip ne l'incluent pas.

Les deux sont des projets xUnit. dotnet-console vérifie I18n.cs. dotnet-resx vérifie I18nResx.cs et les satellites .resx. Aucun n'appelle d'API de traduction. Exécutez dotnet test dans le répertoire. À partir d'un clone complet, pnpm test:dotnet à la racine du dépôt exécute les deux et ignore si dotnet n'est pas sur PATH.

Décompressez ai-i18n-tools-dotnet-examples.zip, puis exécutez les vérifications depuis le répertoire d'exemple. L'archive conserve examples/ et assets/dotnet côte à côte, ce qui est le chemin que les projets compilent :

bash
cd examples/dotnet-console
dotnet test

degit copie un répertoire et n'inclut pas assets/dotnet. Ces liens de compilation se résolvent dans un clone complet, ou après avoir décompressé le fichier zip.

Quel exemple correspond à mon projet ? ​

Liste des exemples ​

ExempleIdéal pourCopier avec degitExécuter
console-appLa plus petite application fonctionnelle avec des chaînes d'interface utilisateur t() + traduction du READMEnpx degit wsj-br/ai-i18n-tools/examples/console-app console-apppnpm start
nextjs-appReact / Next.js + pluriels + tableau de bord ; documentation Docusaurus imbriquée + fichier README plat + ressources SVGnpx degit wsj-br/ai-i18n-tools/examples/nextjs-app nextjs-apppnpm dev (application :3030 ; cd docs-site && pnpm start pour la documentation :3040)
docusaurus-docsSite de documentation Docusaurus uniquement (préréglage docusaurus)npx degit wsj-br/ai-i18n-tools/examples/docusaurus-docs docusaurus-docspnpm start (:3100 ; compilation + service, le menu des paramètres régionaux fonctionne)
astro-websitePage de destination Astro : HTML pleine page + hybride t()npx degit wsj-br/ai-i18n-tools/examples/astro-website astro-websitepnpm dev
astro-docsSite de documentation Astro Starlightnpx degit wsj-br/ai-i18n-tools/examples/astro-docs astro-docspnpm dev (:3050)
vitepress-docsSite de documentation VitePress + thème 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 / squelette de dictionnaire .ts, plus un composant serveur t() (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 / catalogue d'interface utilisateur (pt, zh, analyseur de points)npx degit wsj-br/ai-i18n-tools/examples/fumadocs-docs fumadocs-docspnpm run dev (:3080)
plain-htmlHTML simple + marqueurs data-i18n* ; JSON de paramètres régionaux statiques (interface utilisateur de type tableau de bord)npx degit wsj-br/ai-i18n-tools/examples/plain-html plain-htmlpnpm dev (:3090)
plain-html-docsHTML simple comme documents : une page par locale, images localisées, hreflangnpx degit wsj-br/ai-i18n-tools/examples/plain-html-docs plain-html-docspnpm dev (:3092)
multi-providerChoisir ou évaluer un fournisseur LLM (-P / --provider)npx degit wsj-br/ai-i18n-tools/examples/multi-provider multi-providerai-i18n-tools translate-docs -P openai --force
test-markdownTest de régression de la traduction Markdown / CJK (Devanagari, MDX)npx degit wsj-br/ai-i18n-tools/examples/test-markdown test-markdownpnpm build
intlayer-migrationIntlayer .content.ts → t() (migrate-intlayer, réinitialisation + rapport d'agent IA)npx degit wsj-br/ai-i18n-tools/examples/intlayer-migration intlayer-migrationpnpm reset && pnpm dev (:3091)
intlayer-translateConserver Intlayer, remplir les locales manquantes sur place (translate-intlayer ; en + pt-BR livrés, es + zh-Hans manquants)npx degit wsj-br/ai-i18n-tools/examples/intlayer-translate intlayer-translatepnpm reset && pnpm translate (pnpm dev :3093)
python-streamlitTableau de bord Streamlit, t() / _(), JSON de chaînes sourcenpx 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() / _(), JSON de chaînes sourcenpx 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, locale ContextVar, t() / _(), JSON de chaînes sourcenpx degit wsj-br/ai-i18n-tools/examples/python-fastapi python-fastapipython3 -m venv .venv && pip install -r requirements.txt && uvicorn app:app
python-gettextCLI GNU gettext existante ; extract / translate-ui actualise .po et .monpx degit wsj-br/ai-i18n-tools/examples/python-gettext python-gettextpython3 app.py --lang es
dotnet-consoleVérifications xUnit de I18n.cs : JSON intégré, repli de culture, {0}, pluriels, et Configurenpx degit wsj-br/ai-i18n-tools/examples/dotnet-console dotnet-consoledotnet test
dotnet-resxVérifications xUnit de I18nResx.cs et des satellites .resx de chaînes sourcenpx degit wsj-br/ai-i18n-tools/examples/dotnet-resx dotnet-resxdotnet test

Chaque nom d'exemple renvoie à son fichier README GitHub avec la configuration complète, les commandes et la disposition du projet — ou parcourez l'index des exemples dans le référentiel.

Les exemples Node.js installent la CLI depuis npm après pnpm install. Les quatre exemples Python utilisent venv et pip (python-gettext utilise uniquement la bibliothèque standard) et l'exécutable autonome pour la traduction. Les deux exemples .NET sont des projets xUnit. Exécutez-les avec dotnet test. Ils se trouvent également dans ai-i18n-tools-dotnet-examples.zip sur la version GitHub.


Avis de non-responsabilité

Les noms de produits et les icônes appartiennent à leurs propriétaires respectifs et sont utilisés uniquement à des fins d'identification. Ce logiciel n'est ni affilié ni approuvé par ces marques.

Publié sous licence MIT.