Traduire un fichier YAML en anglais

Ce qui change quand un YAML passe du français à l'anglais

Dans un fichier de traduction YAML, seules les valeurs sont du texte destiné à l'utilisateur. Vers l'anglais, elles raccourcissent en général de 10 à 15 % : Enregistrer les modifications devient Save changes. Les boutons et menus qui débordaient en français retrouvent de la marge ; c'est rarement l'anglais qui casse une mise en page.

D'autres différences sont moins visibles :

• Ponctuation : l'espace avant « : ; ? ! » disparaît et les guillemets « » laissent place aux guillemets anglais. Supprimer ce fichier ? devient Delete this file?.
• Majuscules : les mois et les jours prennent une capitale en anglais. Dans un fichier Rails, le tableau month_names passe de janvier à January.
• Apostrophes : l'anglais en contient beaucoup (don't, you're). Dans une valeur entre apostrophes simples, YAML exige de les doubler : 'Don''t show again'.
• Clé racine : dans Rails ou i18n-js, fr: devient en: ; le reste de l'arborescence ne bouge pas.

Pluriels, variables et formats : les pièges propres à l'anglais

L'anglais n'a que deux catégories de pluriel : one et other. La règle n'est pas celle du français : en français, one couvre 0 et 1 (« 0 message ») ; en anglais, one ne vaut que pour 1 et zéro passe par other (« 0 messages »). Les clés sont identiques, mais le comportement change. Si le fichier source contient une catégorie many, que le français prévoit pour les grands nombres, elle n'existe pas en anglais : les pluriels sont adaptés à la langue cible.

Les variables %{name} et {name} restent intactes, mais leur place dans la phrase bouge souvent : Bonjour %{name}, vous avez %{count} notifications devient Hi %{name}, you have %{count} notifications. Une phrase comme Fichier %{file} supprimé par %{user} se réorganise en anglais autour des mêmes variables.

Les formats de date, eux, ne sont pas traduits. Une valeur default: '%d/%m/%Y' reste telle quelle : c'est l'ordre attendu au Royaume-Uni, mais un public américain lit %m/%d/%Y. De même, contrôlez vous-même les séparateurs décimaux (virgule en français, point en anglais) dans des clés comme number.format.separator.

Anglais britannique ou américain : à décider avant

L'anglais n'est pas un bloc unique : colour ou color, organise ou organize, cancelled ou canceled. Un même fichier doit rester cohérent. Regardez l'orthographe retenue dans l'extrait gratuit avant de payer : il montre un paragraphe de votre fichier traduit au niveau choisi.

Si votre application distingue en-GB et en-US, le plus simple est de partir d'un seul fichier anglais, puis de dupliquer et d'ajuster les valeurs qui diffèrent : orthographe, format de date, parfois vocabulaire (postcode / zip code, mobile / cell phone). Dans Rails, la clé racine du second fichier devient alors en-GB: ou en-US:, à modifier de votre côté.

Le registre compte aussi : l'anglais d'interface ne distingue pas tu et vous, et il est souvent plus direct que le français. Veuillez saisir votre adresse devient naturellement Enter your address, sans formule de politesse.

Ce que Manuce rend exactement, et ce qu'il ne fait pas

Vous recevez le même fichier YAML, prêt à remettre dans le projet : indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM conservés. Les ancres et alias (&defaults, *defaults), les blocs | et > sont préservés, et la clé racine de langue est gérée pour Rails, Symfony, Hugo et i18n-js. Seules les valeurs changent.

Chaque valeur traduite est comparée à la source : si un %{count} ou une balise manque et que l'écart persiste, la valeur source est gardée et le rapport le signale. Ce rapport liste aussi les chaînes traduites et celles laissées telles quelles, avec la raison.

Ne sont pas traduits : les clés, les valeurs vides, les URL, les adresses email, les nombres, les couleurs (#1A73E8), les formats de date, les identifiants et tout ce qui est marqué non traduisible. Le prix porte sur les mots des valeurs, clés et balises exclues.

Manuce ne convertit pas les formats de date pour un public américain et ne reçoit ni glossaire ni consignes de terminologie. Il ne produit pas non plus de traduction assermentée, sans objet pour un fichier d'interface.

Préparer le fichier et vérifier après livraison

• Vérifiez que le fichier source se charge sans erreur : un YAML déjà invalide en français le restera en anglais.
• Repérez les valeurs déjà en anglais dans le fichier français (Dashboard, Login) : elles seront traitées comme le reste, relisez-les dans le résultat.
• Pour un nom de produit ou de fonction à garder tel quel (par exemple Espace Pro), vérifiez-le dans l'extrait gratuit, puis dans la traduction livrée.
• Après livraison, rechargez le fichier avec un analyseur YAML (YAML.load_file en Ruby, yaml.safe_load en Python), puis lancez l'application en anglais.
• Testez les pluriels avec 0, 1 et 2 : en anglais, 0 doit afficher la forme other.
• Lisez le rapport : une valeur restée en français y est expliquée.

En pratique

1. Exportez le fichier de langue source, par exemple config/locales/fr.yml ou messages.fr.yaml.
2. Déposez-le sur Manuce : le devis s'affiche aussitôt, calculé sur les mots des valeurs.
3. Choisissez le niveau et lisez l'extrait gratuit, notamment l'orthographe britannique ou américaine.
4. Téléchargez le fichier anglais et le rapport, puis validez le YAML avec votre analyseur.
5. Remettez le fichier dans le projet et testez l'interface en anglais, pluriels compris.