Le copy produit est prêt pour la localisation quand il a d’abord une source unique : un copy éparpillé dans les composants sous forme de littéraux ne devient pas prêt pour la localisation en le réécrivant, faute de source convenue à traduire. Le travail sur la clarté, les glossaires et les guides de style compte, mais il ne paie qu’une fois les chaînes réunies dans un seul catalogue. Voici la séquence, dans l’ordre qui fonctionne.
La plupart des conseils sur le sujet commencent à l’étape deux. Écrire en langage simple, éviter les idiomes, donner du contexte aux traducteurs : tout cela est juste, mais rien n’est applicable tant que le même message existe sous cinq formes légèrement différentes dans vos composants. Le contexte de fond, et l’argument pour faire de la codebase la source de vérité du copy produit, se trouvent dans le copy produit natif du code. Cette page présente l’ordre des opérations, côté pratique.
Que signifie « prêt pour la localisation » ?
Cela signifie qu’un traducteur, ou un outil de traduction, peut recevoir votre copy et produire une version fidèle sans deviner. Trois conditions : chaque chaîne existe à un seul endroit convenu, chaque chaîne dit une seule chose claire, et la personne qui la traduit sait où et comment elle est utilisée.
Les trois ne se rattrapent pas avec la même facilité. Une formulation peut être clarifiée chaîne par chaîne. Le contexte peut s’ajouter sous forme de notes. Mais « un seul endroit convenu » est une question de structure. Sans lui, les deux autres n’ont rien de stable où s’ancrer : impossible d’améliorer une chaîne dont le jumeau vit dans un autre fichier, ou d’annoter un message qui n’a pas d’adresse unique.
Pourquoi la source plafonne-t-elle la qualité de la traduction ?
Parce que la traduction est un travail dérivé, et qu’un travail dérivé hérite de tous les défauts de ce dont il dérive. Une traduction transporte l’ambiguïté de la source dans chaque langue cible, ainsi que l’incohérence. Si la source dit « Sign in » sur un écran, « Log in » sur un autre et « Login » sur un troisième, vous avez désormais trois termes dans chaque langue, traduits indépendamment, sans moyen de dire lequel est le bon.
C’est aussi pourquoi la correction habituelle, qui consiste à polir les traductions, s’attaque au mauvais bout. Chaque langue ajoutée multiplie le coût d’une source non corrigée. Corriger la source une fois la corrige partout, y compris dans les langues que vous n’avez pas encore ajoutées.
Cet échec de fond a un nom. Le copy drift, c’est le texte visible par l’utilisateur qui s’écarte de sa source approuvée selon les surfaces et au fil du temps, faute de source unique de vérité. Qu’est-ce que le copy drift en détaille les causes. La localisation est le moment où il devient coûteux, car la dérive est copiée dans chaque langue.
Pourquoi un copy éparpillé ne peut-il pas devenir prêt pour la localisation ?
Parce qu’il n’y a rien à transmettre. Un littéral dans un composant n’est pas une unité que l’étape de traduction peut récupérer. Il est mêlé au balisage et à la logique, il peut être assemblé à partir de fragments, et la même phrase peut exister dans plusieurs fichiers avec de petites différences que personne n’a choisies.
Réécrire ces littéraux sur place n’y change rien. Vous pouvez rendre chacun plus clair et n’avoir toujours ni catalogue, ni liste convenue de ce que dit le produit, ni moyen de savoir si vous les avez tous trouvés. Le résultat : un texte plus propre, mais aux mêmes endroits éparpillés.
La première étape n’est donc pas un travail d’édition. C’est un travail de collecte : mettre chaque chaîne visible par l’utilisateur dans un seul catalogue, dans une seule langue source, dans le dépôt, référencée par clé depuis les composants. Sans changer la formulation. Cette passe sert à établir ce que le produit dit actuellement, y compris les passages qui se contredisent.
Comment collecter les chaînes ?
Déplacez-les d’abord dans un catalogue, améliorez-les ensuite. Deux raisons à cet ordre. Une passe mixte, où vous reformulez en déplaçant, masque ce qui a changé aux relecteurs comme à vous. Et une fois tout réuni dans un seul fichier, les doublons et quasi-doublons cessent d’être invisibles : ils se retrouvent côte à côte, et le nettoyage se résume à lire un seul fichier.
Concrètement :
- Choisissez un catalogue par langue source, dans le repo. Une source de référence que les humains comme les outils savent lire. L’organisation et le nommage des clés sont traités dans comment garder des textes d’interface cohérents dans une codebase ; c’est le même catalogue, cette page-là fait donc référence et celle-ci ne le répète pas.
- Remplacez les littéraux par des références de clé. Chaque chaîne lisible par un utilisateur, y compris les libellés de boutons, messages d’erreur, états vides, infobulles et textes d’accessibilité, qui sont les oubliés habituels.
- Gardez les phrases entières. Si un message est construit en assemblant des fragments, faites-en une seule entrée avec des variables, pour que l’unité vue par le traducteur soit celle lue par l’utilisateur. L’ordre des mots varie d’une langue à l’autre, et une phrase assemblée dans le code ne peut pas le suivre.
- Ne reformulez pas encore. Résistez. Vous tomberez sur des chaînes bancales : notez-les et avancez.
Si cette liste ressemble à un mois de travail minutieux sur une grosse codebase, c’est le coût réel de l’étape, et la raison pour laquelle la plupart des équipes calent ici.
Que faire une fois les chaînes dans un seul catalogue ?
Les conseils habituels ont enfin quelque chose sur quoi s’appliquer. Avec un seul catalogue, chacun devient une passe unique au lieu d’une chasse :
- Supprimez les doublons et quasi-doublons. Choisissez la formulation approuvée pour chaque message et faites-y pointer tous les usages.
- Figez les termes qui ne doivent jamais varier. Noms de fonctionnalités, verbes des actions principales, mots que vous avez décidé de proscrire. Écrivez-les une fois. C’est votre glossaire, et il est court.
- Écrivez simplement. Voix active, pas d’idiomes, pas de blagues qui reposent sur un jeu de mots propre à une langue, sigles développés quand ils peuvent être mal compris. Chaque chaîne dit une seule chose.
- Donnez du contexte aux traducteurs. Une note sur l’endroit où la chaîne apparaît et sur ce que représente une variable. Les chaînes courtes comme « Post » ou « Order » sont le piège classique : nom ou verbe, et la langue cible peut exiger un mot différent pour chacun.
- Prévoyez la longueur. Le texte traduit est souvent plus long que la source : concevez des layouts qui ne cassent pas quand un libellé s’allonge. Voyez-y une contrainte de design plutôt qu’un chiffre à anticiper.
Chaque étape est rapide parce que le catalogue est l’unique endroit où elle se déroule. Sans catalogue, ces cinq étapes sont cinq chasses au trésor dans la codebase, et vous ne savez jamais quand vous avez fini.
Que régler avant de choisir un prestataire ou un outil de traduction ?
La source et le circuit de relecture. Un prestataire ou un outil traduit ce que vous lui donnez. Donnez-lui un catalogue propre et un glossaire court, il fera du bon travail. Donnez-lui des littéraux éparpillés, et vous paierez pour traduire les incohérences, puis pour les corriger dans chaque langue.
Décidez trois choses d’abord. Quel fichier est la source de vérité. Qui valide un changement de formulation. Et comment une chaîne modifiée ou nouvelle arrive à la traduction : à la main, par un script, ou par une pull request qui arrive avec les traductions jointes. C’est cette dernière option qui évite que les traductions prennent du retard sur la source, le problème décrit dans pourquoi les fichiers de traduction se désynchronisent.
Qu’est-ce qui change quand les textes de l’interface vivent déjà dans le dépôt ?
La localisation cesse d’être un projet à part. Quand le catalogue est dans le repo, une chaîne nouvelle ou modifiée apparaît comme une ligne dans un diff, ses traductions peuvent être produites et relues dans le même flux de pull request que le code, et personne n’a à exporter un tableur en espérant le récupérer dans le bon ordre.
C’est pourquoi, dans une codebase, garder les textes cohérents et les garder prêts pour la localisation, c’est la même opération. Les deux reposent sur une seule source convenue. Faites le travail une fois et vous obtenez les deux. Les équipes qui construisent avec des outils de code IA le ressentent plus tôt : un agent reformulera ou réintroduira un littéral sans prévenir, sauf si le catalogue et une règle de lint l’en empêchent. Comment empêcher les agents de code IA de réécrire les textes de votre interface traite ce cas.
Où se place globalize.now
globalize.now est un système de gestion des textes natif du code, avec la localisation intégrée, et l’étape de source unique décrite ci-dessus est la partie qu’il prend en charge pour vous. Vous connectez un dépôt GitHub ou GitLab dans l’app. Un scan détermine ce qui s’y trouve. Si les chaînes sont des littéraux dans les composants, une conversion unique les place derrière des clés dans un catalogue et ajoute la configuration i18n s’il n’y en a pas ; si vous utilisez déjà une bibliothèque comme next-intl, react-i18next, i18next ou Lingui, il travaille avec l’existant. Le résultat arrive sous forme de pull request sur sa propre branche : le premier catalogue passe donc exactement par la relecture décrite plus haut. Ensuite, les nouvelles chaînes sources que vous ajoutez sont traduites par des jobs déclenchés au push, qui ouvrent une pull request avec le résultat. Le dépôt reste l’unique source de vérité, et le guide sur les configurations i18n existantes détaille ce que le scan trouve quand une configuration est déjà en place.
Notre objectif : appliquer cette même discipline au site marketing, à la landing page et au produit, depuis une seule source. C’est la direction que nous prenons, pas quelque chose à acheter aujourd’hui. Les tarifs sont sur la page de tarification.
L’ordre, en bref
- Réunissez chaque chaîne visible par l’utilisateur dans un seul catalogue, dans le dépôt. Ne reformulez pas.
- Gardez les phrases entières et référencez chaque chaîne par clé.
- Supprimez les doublons et choisissez une seule fois la formulation approuvée.
- Rédigez le court glossaire des termes qui ne varient jamais.
- Relisez pour simplifier le langage et ajoutez des notes de contexte pour les traducteurs.
- Décidez qui valide les formulations et comment les chaînes modifiées arrivent à la traduction.
- Seulement ensuite, choisissez ou changez de prestataire ou d’outil de traduction.
Si la première étape ressemble à un mois de travail, connectez un dépôt, lisez le plan que l’outil propose et relisez la pull request qu’il ouvre.
globalize.now transforme le texte codé en dur de votre application en fichiers de traduction prêts à l'emploi et les maintient à jour au fur et à mesure de vos déploiements.
Essayer globalize.now gratuitement