Partez de votre projet existant
Un seul langage aujourd'hui ? Commencez ici. Ce langage peut être n'importe quel langage : définissez-le comme sourceLocale. L'anglais est un exemple courant dans ces guides. L'internationalisation (i18n) prépare votre projet à prendre en charge différentes langues ; ces guides vous mènent de la configuration à votre première expérience traduite, y compris le fichier README que votre dépôt affiche déjà sur GitHub, GitLab ou tout autre hébergeur.
Application JavaScript ou TypeScript
Transformez les boutons, étiquettes et messages en texte brut en une interface utilisateur multilingue. Configurez votre environnement d'exécution, marquez le texte à traduire et configurez le basculement de langue. Inclut des invites d'agent de codage pour l'étape de préparation.
React · Next.js · Node.js · CLI
Ajouter l'i18n à une application JS/TS
Application Python
Encapsulez le texte destiné à l'utilisateur et chargez les messages traduits avec un utilitaire généré. Vous utilisez déjà Django ou GNU gettext ? Conservez vos appels gettext et laissez l'outil remplir les fichiers .po. Exécutez la CLI de traduction à partir d'un exécutable autonome sans installation Node.js séparée.
Streamlit · FastAPI · Flask · Django · CLI
Ajouter l'i18n à une application Python · Ajouter l'i18n à une application Django / Python gettext
Application .NET
Encapsulez le texte C# et XAML et chargez les traductions à partir de JSON intégré, ou conservez ResourceManager et écrivez des fichiers satellites .resx. Une commande de simulation transforme l'interpolation en appels T() et liste les clés de ressources nommées, telles que Resources.LoginButton, à convertir.
Avalonia · WPF · MAUI · ASP.NET · Blazor
Ajouter l'i18n à une application .NET · Ajouter l'i18n à une application .NET ResourceManager
Site web ou documentation
Publiez des pages localisées et connectez-les aux routes linguistiques de votre site. Suivez les étapes spécifiques au framework pour la navigation, les étiquettes de thème et le menu de langue.
VitePress · Starlight · Docusaurus · Astro
Ajouter l'i18n à un site web ou de documentation
Fichier README et documentation du dépôt
Traduisez README.md et les autres fichiers Markdown en un fichier par langue, avec une rangée de liens entre eux. Associez-le aux chaînes d'interface utilisateur de votre application, ou traduisez le README seul.
GitHub · GitLab · Bitbucket
Ajouter l'i18n à vos fichiers README et documents Markdown
Vous ne savez pas quel chemin choisir ? Ajouter l'i18n à votre projet liste toutes les procédures pas à pas. Découvrez ce que font les outils ai-i18n-tools pour comprendre comment les pipelines s'articulent.
De la configuration à votre première nouvelle langue
- Préparez votre projet. Choisissez vos langues, un fournisseur de traduction et les modèles à essayer. Pour les applications, marquez le texte visible par l'utilisateur et configurez l'environnement d'exécution de la traduction. Pour les sites, activez le routage linguistique de votre framework. Les guides incluent des invites d'agent de codage là où des modifications du code source sont nécessaires.
- Traduisez dans des fichiers que vous pouvez utiliser. Une fois la configuration prête, exécutez
sync. Il extrait les chaînes d'application prises en charge, traduit le contenu que vous avez activé et écrit des fichiers de localisation ou des pages localisées. - Chargez, vérifiez et continuez. Connectez la sortie à votre application ou site, configurez le basculement de langue et vérifiez une langue cible. Réexécutez après les modifications du code source pour traduire le texte nouveau ou modifié.
Vous gérez la configuration du runtime et du routage, manuellement ou avec un agent de codage. La CLI gère l'extraction, la traduction, la validation et la génération de fichiers — pas la réécriture automatique de la source ni l'installation du sélecteur de langue. Suivez le guide de démarrage rapide complet.
Votre texte source. Prêt pour d'autres langues.
Cet exemple JS/TS illustratif montre la forme du résultat après la configuration et la traduction à l'exécution. Le marquage de la chaîne source la rend détectable ; chaque fichier de paramètres régionaux généré mappe cette phrase à sa traduction.
La phrase source reste lisible dans votre code. Votre application charge les fichiers de paramètres régionaux générés à l'exécution. Vous voulez voir le câblage complet ? Explorez l'exemple Next.js fonctionnel. Les sites web suivent un chemin différent : générez des pages localisées au lieu d'encapsuler chaque paragraphe.
Conçu également pour la prochaine mise à jour
Choisissez votre fournisseur et vos modèles
Utilisez des fournisseurs pris en charge tels que OpenAI, Anthropic, OpenRouter, Gemini, Ollama en local, ou neuf autres options intégrées. Vous pouvez également utiliser n'importe quel fournisseur compatible avec OpenAI. La qualité de la traduction suit la liste des modèles (translationModels, plus les dérogations par langue). suggest-models construit cette liste à partir de benchmarks de traduction publiés, et le même classement est appliqué sous Modèles dans le tableau de bord.
Fournisseurs de LLM · Modèles d'IA
Réutilisez le travail déjà effectué
Les traductions mises en cache permettent aux réexécutions de se concentrer sur le texte nouveau ou modifié plutôt que de tout traduire à nouveau.
Maintenir la traduction
Révisez les résultats de l'IA en local
Inspectez les traductions, corrigez la formulation et gérez la terminologie dans le tableau de bord de traduction.
Consulter le tableau de bord
Conservez l'application et le contenu ensemble
Traduisez les messages d'application, la documentation, les fichiers JSON de locale imbriqués et les étiquettes de texte SVG à partir d'une seule configuration. Activez uniquement ce dont vous avez besoin.
Combinaison de pipelines
Traduisez le fichier README avec l'application
Un seul sync couvre les chaînes d'interface utilisateur et le Markdown du dépôt, et écrit une ligne de langue dans le README.
Ajouter l'i18n à vos fichiers README et documents Markdown
Découvrez d'abord un projet fonctionnel
Ces exemples incluent la configuration et les fichiers traduits validés. Explorez le résultat sans clé API ; relancer la traduction nécessite un fournisseur configuré et généralement une clé. Ollama local n'a pas besoin de clé API.
Une application multilingue
Découvrez les composants React, le câblage d'exécution, les pluriels et le changement de langue dans un projet Next.js fonctionnel.
Explorer l'exemple Next.js
Python en pratique
Découvrez comment une application Streamlit encapsule ses messages et utilise du JSON traduit sans ajouter d'environnement d'exécution JavaScript à l'application.
Explorer l'exemple Streamlit
Documentation dans d'autres langues
Visualisez les pages VitePress traduites ainsi que la navigation et les étiquettes de thème localisées.
Explorer l'exemple VitePress
Parcourir tous les exemples exécutables, y compris les assistants .NET, le HTML simple, d'autres frameworks et les workflows i18n existants.
Vous avez déjà l'i18n ? Conservez ce qui fonctionne.
Vous n'avez pas à tout recommencer.
Vous avez aussi des diagrammes ? Traduisez les étiquettes de texte SVG en même temps que votre application ou vos documents.
Prêt à ajouter votre première langue ?
Pour aller plus loin
Intégrations · Fournisseurs de LLM · Modèles d'IA · Configuration · Référence de la CLI
À propos de ce site
L'interface et la documentation non-anglaises ont été traduites avec ai-i18n-tools. Les traductions IA peuvent contenir des erreurs.
Tous les noms de produits, logos et marques déposées sont la propriété de leurs propriétaires respectifs. Les icônes et les noms sont utilisés à des fins d'identification uniquement. Ce projet n'est pas affilié à ces marques ni approuvé par celles-ci.