Base de connaissances

Réponses aux questions fréquentes sur la localisation d’applications, de documentation et de contenu avec General Translation.

Internationalisation

Mise en place de l’i18n dans une base de code : bibliothèques, frameworks et composants.

Comment traduire une application Flask ou FastAPI ?Marquez les chaînes visibles par l’utilisateur, déterminez le paramètre régional de chaque requête (généralement à partir de l’en-tête Accept-Language), puis chargez les traductions correspondantes. Les applications Flask s’appuient généralement sur Flask-Babel et des catalogues gettext, tandis que les applications FastAPI intègrent Babel dans un middleware. La CLI de General Translation remplit ces catalogues, et ses SDK expérimentaux gt-flask et gt-fastapi traduisent les chaînes t() intégrées au code, sans catalogue.Vidéo52 s
Comment localiser une application Android avec strings.xml ?Placez toutes les chaînes de caractères par défaut dans res/values/strings.xml, ajoutez un strings.xml pour chaque langue dans un dossier qualifié par paramètre régional, comme values-es ou values-b+zh+Hant+TW, et lisez le texte avec stringResource ou getString. Traduisez à la main, dans la Play Console ou avec la CLI de General Translation, qui génère chaque dossier values et reconstruit les formes plurielles pour chaque langue cible.Vidéo49 s
Comment ajouter l’i18n à une application Next.js utilisant le Pages Router ?Ajoutez un bloc i18n contenant locales et defaultLocale à next.config.js, et Next.js sert /es et /fr, redirige les visiteurs selon la langue de leur navigateur et transmet le paramètre régional à getStaticProps et getServerSideProps. Une bibliothèque se charge d’afficher les messages ; gt-next de General Translation génère en plus les traductions à partir du texte intégré dans le JSX.Vidéo55 s
Comment ajouter l’i18n à TanStack Start ?TanStack Start ne propose pas d’i18n intégrée. Il faut donc ajouter une bibliothèque qui résout le paramètre régional à chaque requête serveur, généralement à partir d’un préfixe d’URL ou d’un cookie, et qui charge les messages avant l’affichage. Paraglide JS, react-i18next et Lingui affichent les traductions que vous leur fournissez ; le package expérimental gt-tanstack-start de General Translation les génère en plus à partir du texte intégré dans le JSX.Vidéo48 s
Comment traduire une application Vue ?Traduire une application Vue consiste à faire passer chaque chaîne de caractères des modèles par une recherche dans la langue active, puis à la traduire dans chaque langue cible. Le plugin gt-vue de General Translation traduit le contenu encapsulé dans le composant <T>, et npx gt translate génère un catalogue par langue cible.Vidéo48 s
Comment traduire une application React Native ?Marquez le texte dans vos composants, générez un fichier de traduction pour chaque langue, ajoutez des polyfills Intl et chargez le fichier correspondant à la langue de l’appareil. Avec gt-react-native, la bibliothèque expérimentale de General Translation, vous encapsulez le texte dans <T>, un plugin Babel ajoute les polyfills et npx gt translate génère les fichiers.Vidéo47 s
Comment traduire une application React ?Traduire une application React consiste à internationaliser ses composants pour qu’ils s’affichent dans la langue de l’utilisateur, puis à traduire chaque chaîne de caractères dans chacune des langues prises en charge. gt-react de General Translation traduit le JSX sur place dans le composant <T>, et npx gt translate génère un fichier par langue.Vidéo48 s
Comment traduire une application Node.js ?Détectez la langue de chaque requête, généralement à partir de son en-tête Accept-Language, et renvoyez toutes les chaînes dans cette langue. Le package gt-node de General Translation lie le paramètre régional à chaque requête avec withGT et traduit les chaînes avec getGT, à partir des traductions générées par npx gt translate --publish avant le déploiement.Vidéo48 s
Comment traduire des chaînes en dehors du JSX ?Faites passer chaque chaîne qui n’est pas un enfant JSX, comme un espace réservé ou une constante définie au niveau du module, par une fonction de traduction à l’endroit où elle est affichée. Le hook useGT de General Translation renvoie cette fonction, et msg, combiné à useMessages, traduit les constantes définies en dehors d’un composant.Vidéo49 s
Comment internationaliser une application avec Cursor ou Claude Code ?Commencez par le prompt Setup for Agents de General Translation dans Cursor ou Claude Code, choisissez une fonctionnalité et des langues cibles, puis laissez l’agent implémenter et vérifier le résultat. La connexion via le navigateur, la documentation lisible par machine et les outils MCP font le lien entre la configuration initiale, la traduction et la relecture. Utilisez Locadex pour automatiser la localisation continue au moyen de pull requests.Vidéo46 s
Comment ajouter l’i18n à une application Next.js App Router ?Commencez par gt init pour configurer General Translation dans un projet App Router pris en charge, puis balisez le contenu source, générez les traductions et vérifiez le changement de langue. gt-next conserve les textes dans le JSX avec leur contexte de traduction ; la CLI, l’éditeur du tableau de bord et Locadex prennent en charge la génération, la relecture et les mises à jour continues. Ce guide présente également la configuration initiale explicite avec des fichiers locaux.Vidéo51 s
Qu’est-ce que la pseudo-localisation ?La pseudo-localisation est un test qui remplace votre texte source par une version modifiée, accentuée, allongée d’environ 40 % et encadrée de crochets, afin de faire apparaître les chaînes codées en dur, les troncatures, les polices défaillantes et les phrases concaténées avant même qu’une traduction n’existe. Android propose à cet effet les pseudo-paramètres régionaux en-XA et ar-XB.Vidéo48 s
Internationalisation et localisation (i18n et l10n)L’internationalisation (i18n) désigne le travail de code et de conception qui permet à un même produit de prendre en charge de nombreux paramètres régionaux, par exemple le formatage des dates avec Intl ou la prise en charge du texte right-to-left. La localisation (l10n) l’adapte à un paramètre régional donné, ce qui englobe la traduction, mais aussi la devise, les formats de date, les unités, le ton et les aspects juridiques.Vidéo52 s
Comment trouver les chaînes codées en dur qui ne sont pas traduites ?Exécutez dans votre CI un linter qui signale les littéraux de chaîne de caractères visibles par l’utilisateur, comme la règle no-literal-string d’eslint-plugin-i18next pour JSX, la vérification HardcodedText d’Android Lint ou le linter HardCodedString d’erb_lint pour Rails. Parcourez ensuite l’application avec un pseudo-paramètre régional pour repérer le texte que les vérifications statiques ne peuvent pas détecter.Vidéo48 s
Comment rendre un site web multilingue ?Choisissez où stocker les traductions (dans un proxy, un plugin de CMS, un constructeur de sites ou votre propre code), puis attribuez à chaque langue sa propre URL, comme le recommande Google. Traduisez les pages entières ainsi que les titres et les méta-descriptions, reliez les versions avec hreflang et proposez un sélecteur de langue plutôt que de rediriger automatiquement les visiteurs.Vidéo50 s
Comment nommer les clés de traduction i18n ?Nommez les clés selon l’endroit où le texte apparaît et ce qu’il signifie, par exemple checkout.summary.title, et non selon sa formulation anglaise. Attribuez une clé distincte à chaque usage, même si le texte anglais est identique : en allemand, le bouton Open se traduit par Öffnen, alors que l’état Open se traduit par Offen.Vidéo46 s
Comment localiser une app iOS avec les String Catalogs ?Ajoutez vos langues dans Xcode, rédigez le texte destiné aux utilisateurs avec des API localisables comme Text de SwiftUI et String(localized:), puis lancez une compilation pour que Xcode rassemble ces chaînes de caractères dans un String Catalog (.xcstrings). Traduisez dans Xcode, via XLIFF, ou avec la CLI de General Translation si vos catalogues doivent être mis à jour à chaque livraison et partager la même terminologie que votre site web et votre app Android.Vidéo44 s
Comment détecter la langue du navigateur d’un utilisateur ?Lisez la liste ordonnée des langues du navigateur (navigator.languages en JavaScript ou l’en-tête Accept-Language côté serveur), triée par valeur q, puis mettez-la en correspondance avec vos paramètres régionaux pris en charge, en prévoyant une solution de secours. Safari et la navigation privée de Chrome n’indiquent qu’une seule langue, et la géolocalisation par IP révèle l’emplacement, pas la langue.Vidéo47 s
Bonnes pratiques pour le sélecteur de langue : UX, SEO et accessibilitéAffichez chaque langue sous son propre nom, comme Deutsch ou 日本語, et bannissez les drapeaux, qui représentent des pays. Faites pointer chaque option vers la même page dans cette langue grâce à un lien explorable par les robots, mémorisez le choix dans un cookie et ne redirigez jamais automatiquement une URL localisée.Vidéo47 s
Liste de contrôle des tests de localisation pour les applications multilinguesTestez neuf points dans chaque paramètre régional pris en charge sur une compilation de Production : les parcours complets, y compris les états d’erreur et les e-mails, le changement de langue, les formes plurielles, la devise et les fuseaux horaires, le foisonnement du texte, la mise en page right-to-left, l’accessibilité, la distribution des traductions et des URL de langue explorables. Associez à chaque vérification un critère de réussite explicite.Vidéo33 s
General Translation vs i18next, react-intl et next-intl : quelle bibliothèque d’i18n choisir ?Les bibliothèques open source comme i18next, react-intl et next-intl ne traduisent rien. Elles affichent les traductions que vous leur fournissez dans un fichier de catalogue par langue, rédigées par vous, vos traducteurs ou un service tiers. Les bibliothèques de General Translation sont elles aussi open source et remplissent le même rôle, mais General Translation se charge en plus de la traduction, en s’appuyant sur votre code comme contexte.Vidéo43 s
General Translation ou vue-i18n : lequel choisir ?General Translation permet aux équipes Vue d’écrire le texte source directement dans les modèles et de générer les traductions avec la CLI. Son plugin gt-vue affiche ce contenu avec une gestion des formes plurielles et un formatage des nombres adaptés au paramètre régional. Optez pour cette solution si vous ne voulez plus maintenir de fichiers sources à clés ; vue-i18n reste pertinent pour les équipes qui utilisent le module i18n de Nuxt et un workflow de catalogue bien établi.Vidéo42 s
General Translation ou Symfony Translation : lequel choisir ?Symfony Translation affiche les messages en PHP et en Twig. General Translation traduit ses catalogues YAML en CI, les maintient à jour à mesure que votre source évolue et offre aux relecteurs un tableau de bord pour les modifier. Conservez le rendu de Symfony et intégrez la traduction automatisée à votre workflow de livraison.Vidéo44 s
General Translation ou Rails I18n : avez-vous besoin des deux ?Rails I18n recherche les messages et formate les dates et les nombres. General Translation produit les traductions, les tient à jour au fil de l’évolution de votre texte anglais et offre à votre équipe un tableau de bord pour la relecture. Utilisez les deux pour livrer des catalogues Rails traduits à chaque version.Vidéo44 s
General Translation ou Paraglide JS : lequel choisir ?Choisissez General Translation pour garder vos textes intégrés au code et générer des traductions qui tiennent compte de la structure de vos composants React, d’une terminologie partagée et d’une relecture dans le tableau de bord. Choisissez Paraglide JS pour des fonctions de messages compilées et typées, avec un tree-shaking message par message. Paraglide affiche vos catalogues ; General Translation relie vos textes source à la génération des traductions et à leurs mises à jour au fil de l’eau.Vidéo42 s
General Translation ou nestjs-i18n : lequel choisir ?nestjs-i18n résout la langue de chaque requête dans une application NestJS et affiche les messages à partir de catalogues JSON ou YAML propres à chaque langue, mais il ne traduit rien. La CLI de General Translation traduit ces catalogues, et sa bibliothèque gt-node traduit le contenu qui n’existe qu’à l’exécution : vous pouvez donc conserver nestjs-i18n et lui adjoindre General Translation.Vidéo45 s
General Translation ou Mobility : lequel choisir ?Mobility stocke les attributs traduits de vos modèles dans votre base de données. General Translation produit ces traductions via son API, en s’appuyant sur votre glossaire et vos instructions personnalisées. Utilisez les deux pour traduire vos fiches produits, articles et autres contenus de base de données sans renoncer à vos modèles Rails.Vidéo44 s
General Translation ou Lingui : lequel choisir ?Choisissez General Translation pour conserver vos textes intégrés au code comme avec Lingui, tout en générant les traductions à partir de la structure de votre JSX comme contexte. Lingui extrait les messages intégrés dans des catalogues que vos traducteurs ou un service connecté se chargent de traduire. La CLI de General Translation met à jour les traductions au fil de l’évolution de votre code, et votre équipe les relit dans le tableau de bord.Vidéo45 s
General Translation ou le framework de traduction de Django : avez-vous besoin des deux ?Utilisez conjointement le framework de traduction de Django et General Translation. Django gère l’extraction des messages, la sélection de la langue et l’affichage. General Translation remplit ses fichiers PO, formes du pluriel comprises, avec la terminologie de votre produit et une relecture dans le tableau de bord. Vos modèles et vos motifs d’URL restent inchangés, tandis que les traductions évoluent au rythme de votre code.Vidéo46 s
General Translation ou Intlayer : lequel choisir ?Intlayer conserve le contenu de chaque composant dans un fichier de déclaration typé placé juste à côté, où toutes les langues sont écrites côte à côte, et peut compléter les langues manquantes grâce à un fournisseur d’IA que vous configurez. General Translation conserve les textes directement intégrés dans vos composants, dans une seule langue, et génère les autres langues en s’appuyant sur le contexte de votre code.Vidéo42 s
General Translation ou GNU gettext : avez-vous besoin des deux ?Conservez GNU gettext pour l’extraction et l’affichage, et ajoutez General Translation pour générer et maintenir les fichiers PO. General Translation tient compte des notes aux traducteurs et du contexte des messages lors de la génération, applique une terminologie partagée et met à la disposition des relecteurs un éditeur dans le tableau de bord. Vos appels gettext existants et vos catalogues compilés restent en place.Vidéo46 s
General Translation ou Babel et Flask-Babel : lequel choisir ?Babel formate les dates, les nombres et les devises pour n’importe quel paramètre régional et gère les catalogues gettext, tandis que Flask-Babel l’intègre à Flask, mais aucun des deux ne traduit vos chaînes. La CLI de General Translation remplit les fichiers PO de Babel pour chaque langue, formes du pluriel comprises : vous pouvez ainsi conserver Flask-Babel et ne plus traduire vos catalogues à la main.Vidéo46 s
Faut-il développer votre propre i18n ou utiliser General Translation ?Une i18n faite maison (un dictionnaire par langue et un petit utilitaire t()) suffit pour une ou deux langues et un peu de texte. À mesure que l’application grandit, vous finissez par réécrire les règles de pluriel, les solutions de repli et la synchronisation des fichiers, et il vous reste à produire les traductions. Les bibliothèques open source de General Translation gèrent l’affichage, et General Translation génère et met à jour les traductions à partir de votre code.Vidéo43 s
Alternatives à react-intl : General Translation ou react-intlGeneral Translation permet aux équipes React de conserver la syntaxe de messages ICU tout en y ajoutant la génération de traductions, une terminologie partagée et la relecture dans le tableau de bord. react-intl fournit le formatage et l’outillage de catalogues FormatJS ; General Translation produit en plus les traductions.Vidéo47 s
Alternatives à i18next : General Translation ou i18nextChoisissez General Translation pour conserver vos textes directement dans vos composants React et générer des traductions en tirant parti de leur structure JSX et du contexte de votre produit. Vous pouvez aussi conserver i18next et utiliser General Translation pour traduire vos catalogues existants. i18next assure le rendu des messages et la sélection des formes plurielles ; la génération des traductions relève d’un service distinct.Vidéo47 s
Peut-on faire de l’i18n sans fichiers de traduction ?Oui. Les bibliothèques gt-react et gt-next de General Translation permettent d’internationaliser React et Next.js sans clés de traduction ni fichier JSON par langue à maintenir. Le texte reste intégré au JSX, dans le composant <T>, et la commande gt translate génère les traductions de chaque langue lors de la compilation, en s’appuyant sur le contexte de votre code. Locadex peut les tenir à jour via des pull requests.Vidéo46 s
Comment traduire du texte conditionnel en JSX ?Gardez la phrase entière et traduisez chacune de ses versions, car un ternaire la découpe en fragments qui perdent leur sens et leur place dans l’ordre des mots propre à chaque langue. General Translation y parvient avec <Branch> à l’intérieur de <T>, qui traduit la phrase d’un seul tenant.Vidéo46 s

Formatage selon les paramètres régionaux

Formes plurielles, dates, nombres, devises et texte right-to-left pour chaque paramètre régional.

Traduction

Traduction automatique et par IA, qualité, contexte et glossaires.

Référencement multilingue

Routage selon les paramètres régionaux, hreflang, plans de site et métadonnées traduites pour les sites multilingues.

Outils de workflow

Choisir des outils de localisation et synchroniser les traductions grâce à la localisation continue.

Déployez dès aujourd’hui

Rejoignez les meilleures équipes de développeurs au monde sur General Translation

CommencerDemander une démo