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
| Vous | L'outil |
|---|---|
| Choisissez les langues, un fournisseur et les modèles à essayer | Extrait 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 README | Met 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 README | Affiche 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 avez | Commencez ici |
|---|---|
| Une application JS/TS (React, Next.js, Node, CLI) avec du texte brut dans le code source | Ajouter 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 IStringLocalizer | Ajouter l'i18n à une application .NET ResourceManager |
| Une application Django, des catalogues Flask-Babel, ou une application qui utilise déjà GNU gettext | Ajouter 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 application | Ajouter l'i18n à votre README et à vos documents Markdown |
| Fichiers de locale JSON imbriqués autonomes | JSON |
| Diagrammes SVG avec des étiquettes de texte | Traduction SVG |
| Dictionnaires Intlayer (quitter Intlayer) | Migration depuis Intlayer |
| Dictionnaires Intlayer (garder Intlayer, traduire sur place) | Traduction d'Intlayer sur place |
Fonctionnement
- Installez la CLI et définissez la clé API de votre fournisseur : Installation.
- Exécutez
initpour écrireai-i18n-tools.config.json: Démarrage rapide. - 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. - Exécutez
sync. Il extrait le texte, traduit ce qui est nouveau et écrit la sortie. - Chargez la sortie dans votre application ou site, ajoutez un sélecteur de langue, et réexécutez
synclorsque 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, etT("…")/{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
.astrolistées dansdocs[].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.styledeflat). 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 avez | Exemple |
|---|---|
| Une application JS/TS | console-app, nextjs-app |
| Un fichier README de dépôt à côté d'une application | console-app, nextjs-app |
| Une application Python | python-streamlit, python-fastapi, python-gettext |
| Un assistant .NET | dotnet-console, dotnet-resx |
| Un site de documentation | docusaurus-docs, vitepress-docs, astro-docs |
| Un site web ou du HTML simple | astro-website, plain-html |
Voir Exemples pour la liste complète et les commandes de copie npx degit.
Prochaines étapes
- 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.
- Démarrage rapide — générez une configuration et exécutez votre première traduction.
- Fournisseurs de LLM — choisissez un fournisseur, une clé d'API et une substitution
-P. - Modèles d'IA — classez une sélection avec
suggest-modelsou l'onglet Modèles du tableau de bord, et conservez plusieurs modèles afin qu'une traduction ayant échoué puisse essayer le suivant.