Blog

Vérifier chaque traduction avant qu'elle ne soit écrite

Espaces réservés, balises de balisage, chaque forme plurielle CLDR et syntaxe ICU : ce que localize.dev vérifie dans chaque traduction automatique, et ce qui arrive à celle qui échoue.

Stephen Ufort · 3 novembre 2026 · 3 min de lecture

L'écran de connexion du CMS Pages en anglais, espagnol, arabe de droite à gauche et chinois

La traduction automatique échoue de manières qu'un réviseur manque souvent. Un espace réservé est traduit, donc {name} devient {nombre} et l'application affiche les accolades. Une forme plurielle revient avec deux formes pour une langue qui en a besoin de quatre. Une accolade errante se glisse dans une phrase persane, et la bibliothèque i18n plante lorsqu'elle essaie de la rendre.

localize.dev vérifie chaque traduction par rapport à sa source avant de l'écrire dans un fichier de localisation. Cet article passe en revue chaque vérification, en utilisant des cas de la suite de tests.

Espaces réservés : aucun ajouté, aucun perdu

Chaque {placeholder} dans la source doit être dans la traduction, inchangé, et la traduction ne peut pas en ajouter un que la source n'a pas. Le vérificateur signale exactement ce qui s'est mal passé :

test/validate.test.ts
translationProblem('Hi {name}', 'Hola', 'es', opts);
// → 'it lost {name}'

translationProblem('Hi {name}', 'Hola {nombre}', 'es', opts);
// → "it has {nombre}, which the source doesn't"

Il y a une exception. Dans un message pluriel, la forme one peut omettre {count}, car de nombreuses langues disent « un fichier » comme un mot au lieu de « 1 fichier ».

Chaque forme plurielle dont la langue a besoin

L'anglais a deux formes plurielles, one et other. Le polonais en a quatre, l'arabe six et le japonais une. Les formes dont une langue a besoin proviennent de Intl.PluralRules, les données CLDR intégrées à JavaScript, il ne s'agit donc jamais d'une liste tenue à la main.

test/validate.test.ts
const source = { one: '{count} file', other: '{count} files' };

translationProblem(source, { one: '{count} plik', other: '{count} pliku' }, 'pl', opts);
// → 'no "few", "many" form'

translationProblem(source, { other: '{count}個のファイル' }, 'ja', opts);
// → null (Japanese needs only "other")

Lorsque la source a une forme =0 exacte (« Aucun fichier »), chaque traduction en a également besoin. Un pluriel qui revient sous forme de texte brut, ou un texte brut qui revient sous forme de pluriel, est rejeté car sa forme est incorrecte.

Balises de balisage et accolades errantes

Les phrases avec des liens ou du texte en gras sont envoyées avec des balises telles que <a>help center</a>. La traduction peut déplacer les balises pour s'adapter à son ordre de mots, mais elle doit conserver le même ensemble. Une traduction avec plus d'accolades non appariées que sa source est rejetée, ce qui intercepte le cas persan de la suite de tests avant que toute bibliothèque n'ait à la rendre.

Les messages ICU doivent être analysés

Les applications Svelte et les fichiers ARB de Flutter utilisent la syntaxe des messages ICU. Là, une traduction doit également être analysée en tant qu'ICU. ICU a son propre piège : une apostrophe cite le texte qui la suit, donc en français d'{name} afficherait le texte littéral {name} au lieu de la valeur. localize.dev double les apostrophes avant les accolades avant de vérifier, puis vérifie que chaque espace réservé que la traduction devrait avoir est toujours un argument réel.

Ce qui se passe lorsqu'une traduction échoue

  • La langue défaillante est supprimée pour cette chaîne, et la traduction mise en cache est oubliée.
  • La chaîne est renvoyée avec la raison ajoutée à son contexte, par exemple « Une traduction précédente a été rejetée : elle a perdu {name} ».
  • Si la deuxième réponse échoue également, la traduction est omise. L'exécution le signale, et la pull request la liste sous « Traductions omises ».

Rien de cassé n'est écrit. Une traduction manquante est visible : l'application se rabat sur la langue source pour cette chaîne, et localize-dev check signale l'écart jusqu'à ce qu'il soit comblé. Une traduction cassée peut atteindre la production sans être remarquée.

Ce que les vérifications ne peuvent pas vous dire

Ces vérifications interceptent les traductions qui pourraient casser votre application. Elles ne peuvent pas dire si une traduction est bonne. Pour cela, localize.dev vous permet d'attribuer un réviseur par langue. Leurs corrections vont dans la pull request ouverte et chaque exécution ultérieure, et un glossaire maintient les termes du produit identiques partout.

Essayez-le sur votre propre code dans le terrain de jeu, aucun compte requis