Traduire les valeurs d’un fichier de localisation applicative

Traduire des fichiers de localisation sans casser les variables

Traduction de fichiers JSON et YAML : clés, imbrication, types et variables préservés. Une chaîne dont une variable serait perdue reste en version d’origine.

Déposez votre fichier, ou choisissez-le

JSON ou YAML. Les clés et la structure sont conservées à l’identique.

Le fichier n’est envoyé qu’au moment où vous lancez l’analyse. Il est supprimé après traitement.

Ce que fait cet outil

La protection des variables est vérifiée, pas supposée

Après traduction, chaque jeton de protection doit être retrouvé exactement une fois. Un jeton manquant, dupliqué ou résiduel fait retomber la chaîne sur l’original plutôt que de produire une interpolation cassée en production.

Les valeurs techniques sont exclues d’office

URL, adresses e-mail, codes couleur, constantes en majuscules, noms de fichiers, booléens et chaînes composées uniquement de variables ne partent pas au moteur.

Clés sensibles protégées par convention

Les valeurs portées par des clés comme <code>id</code>, <code>slug</code>, <code>url</code>, <code>icon</code>, <code>locale</code>, <code>pattern</code> ou une clé préfixée d’un tiret bas sont laissées intactes.

Exemples

Variables et pluriels ICU préservés

Avant

{
  "cart.items": "Vous avez {count} article(s) dans votre panier",
  "cart.url": "/panier",
  "user.greeting": "Bonjour {{user.firstName}}"
}

Après

{
  "cart.items": "You have {count} item(s) in your cart",
  "cart.url": "/panier",
  "user.greeting": "Hello {{user.firstName}}"
}

Exemple rédigé par la rédaction. Les clés, la variable {count}, la double accolade et la valeur d’URL sont inchangées.

Quand l’utiliser

Ajouter une langue à une application web

Vous partez de votre fichier de référence et obtenez une base traduite à relire, sans retoucher les clés.

Mettre à jour une traduction après une évolution produit

Vous traduisez le fichier complet, puis comparez avec l’existant pour ne reprendre que les chaînes nouvelles.

Traduire une configuration YAML éditoriale

Libellés de navigation, textes de bannière, messages d’erreur : les valeurs rédigées sont traduites, les clés techniques non.

Préparer un fichier pour une plateforme de localisation

La version automatique sert de prétraduction, que vos relecteurs corrigent dans leur outil habituel.

Mode d’emploi

  1. Déposez votre fichier JSON ou YAML : l’analyse compte les chaînes réellement traduisibles.
  2. Vérifiez le nombre de chaînes annoncé : un écart important signale souvent des valeurs techniques, ce qui est normal.
  3. Choisissez la langue cible et lancez la traduction.
  4. Consultez la liste des chaînes laissées en version d’origine, puis traitez-les à la main.

Limites et confidentialité

Ce que cet outil ne fait pas

  • Chaque chaîne est traduite isolément : le moteur ne connaît ni l’écran, ni le contexte d’affichage.
  • Les règles de pluriel ne sont pas adaptées à la langue cible : une structure ICU est préservée, pas réécrite pour les catégories de pluriel du nouveau langage.
  • Les contraintes de longueur d’interface ne sont pas vérifiées ; un libellé de bouton peut devenir trop long.
  • Le genre grammatical des variables n’est pas résolu : « Bienvenue {name} » ne peut pas s’accorder.
  • Les commentaires YAML sont conservés mais non traduits.

Vos données

  • Le fichier est traité en mémoire puis supprimé : il n’est pas conservé après le téléchargement.
  • Le contenu du fichier n’est jamais journalisé. Les journaux techniques ne retiennent que la durée, le moteur, les codes de langue, la taille et le statut.
  • Le nom de votre fichier n’est pas réutilisé côté serveur : il est assaini avant toute écriture.
  • Aucun texte soumis n’est réutilisé pour entraîner un modèle.

Politique de confidentialité complète

Questions fréquentes

Que se passe-t-il si le moteur supprime une variable ?

La chaîne est renvoyée telle qu’elle était avant traduction, et elle apparaît dans la liste des chaînes non traduites avec le motif. Livrer « Vous avez articles » à la place de « Vous avez {count} article(s) » provoquerait un bug en production : nous préférons une chaîne non traduite à une chaîne cassée.

Les pluriels ICU sont-ils adaptés à la langue cible ?

Non. Une structure {count, plural, one {…} other {…}} est préservée intacte, mais les catégories de pluriel varient selon les langues : l’arabe, le polonais ou le russe en comptent davantage que le français. L’adaptation des catégories est un travail de localisation, pas de traduction.

Puis-je traduire un fichier contenant des clés imbriquées profondément ?

Oui. Le parcours est récursif et le chemin de chaque chaîne est conservé, y compris à travers les tableaux. La structure du fichier produit est comparée à celle de l’entrée avant le téléchargement.

Sources

  1. Documentation LibreTranslate — API libre reposant sur Argos Translate, publiée sous AGPL-3.0
  2. Unicode Standard Annex #15 — Unicode Normalization Forms — Révision 58 du 12 août 2026 ; définit les formes NFC, NFD, NFKC et NFKD

Page vérifiée le . Intention dominante de cette page : traduire les valeurs d’un fichier de localisation applicative. Comment nous travaillons.