Skip to content

Qu'est-ce que ai-i18n-tools? ​

Vous avez une application, un site web, un site de documentation ou un fichier README de dépôt dans une seule langue, et vous souhaitez en ajouter d'autres. Cette langue est sourceLocale, et il peut s'agir de n'importe quelle langue. L'anglais est un exemple courant dans ces guides. ai-i18n-tools trouve le texte, le traduit avec les modèles du fournisseur de LLM que vous choisissez et écrit les fichiers que votre projet charge déjà. Il met en cache chaque résultat, de sorte que les réexécutions n'envoient au modèle que le texte nouveau ou modifié.

Ce que vous faites et ce que l'outil fait ​

VousL'outil
Choisissez les langues, un fournisseur et les modèles à essayerExtrait le texte, le traduit, valide le résultat et écrit des catalogues ou des pages
Rendez le texte destiné à l'utilisateur visible par l'outil : appels t() dans le code de l'application, l'i18n propre à votre framework pour un site, ou un marqueur de liste de langues dans un fichier READMEMet en cache les traductions et les réutilise à chaque réexécution
Connecter le résultat à l'application, au routage du site ou à la ligne de langue du fichier READMEAffiche la progression et vous permet d'examiner les traductions dans le tableau de bord

L'outil ne réécrit pas votre code source, sauf si vous exécutez migrate-python-i18n ou migrate-dotnet-i18n avec --write. Des invites de l'agent de codage sont fournies pour l'étape d'encapsulation. Il n'installe pas i18next ni l'i18n du framework de votre site, et il ne construit pas votre sélecteur de langue, bien que des assistants d'exécution soient fournis à cet effet.

Par où commencer ? ​

Les guides pas à pas sont regroupés dans Ajouter l'i18n à votre projet, avec la configuration partagée et une page pour chaque type de projet. Choisissez une ligne :

Vous avezCommencez ici
Une application JS/TS (React, Next.js, Node, CLI) avec du texte brut dans le code sourceAjouter l'i18n à une application JS/TS
Une application Python (Streamlit, FastAPI, Flask, de bureau, scripts)Ajouter l'i18n à une application Python
Une application .NET (Avalonia, WPF, MAUI, ASP.NET, Blazor, console)Ajouter l'i18n à une application .NET
Une application .NET qui utilise déjà ResourceManager ou IStringLocalizerAjouter l'i18n à une application .NET ResourceManager
Une application Django, des catalogues Flask-Babel, ou une application qui utilise déjà GNU gettextAjouter l'i18n à une application Django / Python gettext
Un site web ou un site de documentation (VitePress, Docusaurus, Starlight, Nextra, Fumadocs, Astro, HTML simple)Ajouter l'i18n à un site web ou un site de documentation
Un fichier README de dépôt et d'autres fichiers Markdown, généralement à côté d'une applicationAjouter l'i18n à votre README et à vos documents Markdown
Fichiers de locale JSON imbriqués autonomesJSON
Diagrammes SVG avec des étiquettes de texteTraduction SVG
Dictionnaires Intlayer (quitter Intlayer)Migration depuis Intlayer
Dictionnaires Intlayer (garder Intlayer, traduire sur place)Traduction d'Intlayer sur place

Fonctionnement ​

  1. Installez la CLI et définissez la clé API de votre fournisseur : Installation.
  2. Exécutez init pour écrire ai-i18n-tools.config.json : Démarrage rapide.
  3. Préparez le projet : encapsulez les chaînes dans t(), activez l'i18n de votre framework de site, ou ajoutez le marqueur de liste de langues à un fichier README.
  4. Exécutez sync. Il extrait le texte, traduit ce qui est nouveau et écrit la sortie.
  5. Chargez la sortie dans votre application ou site, ajoutez un sélecteur de langue, et réexécutez sync lorsque le code source change.

Modes de traduction ​

En coulisses, l'outil exécute quatre pipelines. Votre configuration active ceux dont vous avez besoin, et sync les exécute dans l'ordre.

  • Chaînes d'interface utilisateur — Extrait les appels t("…") et _() de JS/TS et Python, et T("…") / {loc:Tr '…'} de C# et XAML (y compris GNU gettext et les satellites .NET .resx) et écrit des fichiers JSON plats par locale, .po / .mo, ou .resx. Commandes : extract, translate-ui, migrate-dotnet-i18n. Guide : Chaînes d'interface utilisateur. Python : Applications Python. .NET : Applications .NET et Ajouter l'i18n à une application .NET ResourceManager.
  • Documents — Traduit les pages Markdown, MDX et .astro listées dans docs[].contentPaths. Fonctionne avec VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro et d'autres sites de documentation statiques, et avec un fichier README de dépôt (docsOutput.style de flat). Commande : translate-docs. Guides : Documents et Ajouter l'i18n à vos documents README et Markdown.
  • JSON — Traduit les bundles de locales JSON imbriqués (libellés de thème, remplacements i18n, texte d'application non présent dans le code source) définis dans le json[] de niveau supérieur. Commande : translate-json. Guide : JSON.
  • SVG — Traduit le texte visible à l'intérieur des illustrations SVG (<text>, <title>, <desc>) et écrit un fichier de sortie par locale. Séparé de la traduction de documents. Commande : translate-svg. Guide : Traduction SVG.

De nombreux projets combinent des modes. La paire courante est les chaînes d'interface utilisateur et le fichier README du dépôt. Un site de documentation tel que VitePress est l'autre paire fréquente. Voir Combiner les pipelines et Ajouter l'i18n à votre README et à vos documents Markdown.

Exemples ​

Le dépôt contient des projets d'exemple exécutables sous examples/, chacun avec sa propre configuration, ses sorties de locales validées et son fichier README. Explorez les fichiers traduits sans clé API ; la réexécution de la traduction nécessite une clé de fournisseur.

Si vous avezExemple
Une application JS/TSconsole-app, nextjs-app
Un fichier README de dépôt à côté d'une applicationconsole-app, nextjs-app
Une application Pythonpython-streamlit, python-fastapi, python-gettext
Un assistant .NETdotnet-console, dotnet-resx
Un site de documentationdocusaurus-docs, vitepress-docs, astro-docs
Un site web ou du HTML simpleastro-website, plain-html

Voir Exemples pour la liste complète et les commandes de copie npx degit.

Prochaines étapes ​

  1. Installation — installez le paquet npm ou téléchargez l'exécutable autonome pour un projet Python, et définissez votre clé d'API de fournisseur.
  2. Démarrage rapide — générez une configuration et exécutez votre première traduction.
  3. Fournisseurs de LLM — choisissez un fournisseur, une clé d'API et une substitution -P.
  4. Modèles d'IA — classez une sélection avec suggest-models ou l'onglet Modèles du tableau de bord, et conservez plusieurs modèles afin qu'une traduction ayant échoué puisse essayer le suivant.

Publié sous licence MIT.