Traduire un fichier YAML en espagnol (Rails, Symfony, Hugo)

Ce qui change quand un YAML passe en espagnol

L'espagnol s'écrit en alphabet latin, de gauche à droite : pas de problème d'encodage particulier si votre fichier est déjà en UTF-8. Les difficultés sont ailleurs, dans le texte lui-même et dans la façon dont votre interface l'affiche.

• Des chaînes plus longues. L'espagnol est plus long que l'anglais, à peu près comme le français. Sign in devient Iniciar sesión, Settings devient Configuración. Les boutons et les onglets à largeur fixe sont les premiers à déborder.
• Les signes inversés. Une question s'ouvre par ¿ et une exclamation par ¡ : Delete this file? donne ¿Eliminar este archivo?. Si votre code ajoute lui-même le « ? » après la valeur, le signe d'ouverture se retrouvera seul en tête de phrase : mieux vaut que toute la phrase soit dans la valeur.
• Les majuscules. L'espagnol ne met une majuscule qu'au premier mot d'un titre : Account Settings devient Configuración de la cuenta, pas « Configuración De La Cuenta ». Les jours et les mois s'écrivent en minuscules (lunes, enero).
• Le genre. Welcome, %{name} se traduit par Bienvenido, %{name} ou Bienvenida, %{name} selon la personne, que le traducteur ne connaît pas. Si vos utilisateurs sont mixtes, relisez ces chaînes et envisagez une tournure neutre comme Te damos la bienvenida, %{name}.
• Espagne ou Amérique latine. Le vocabulaire diffère (ordenador / computadora, móvil / celular), tout comme la deuxième personne du pluriel (vosotros en Espagne, ustedes ailleurs). Vérifiez sur l'extrait gratuit que le vocabulaire et le tutoiement ou vouvoiement (tú / usted) conviennent à votre public.

Pluriels et variables : one, many, other

Les règles CLDR de l'espagnol comptent trois catégories : one, many et other. one sert pour 1, other pour la plupart des autres nombres, y compris 0 (0 artículos, contrairement au français qui dit « 0 article »). many, ajoutée plus récemment, concerne les très grands nombres ronds, de l'ordre du million, où l'espagnol exige de : 1 millón de usuarios.

Exemple Rails :

• one: "%{count} item" devient one: "%{count} artículo"
• other: "%{count} items" devient other: "%{count} artículos"

Manuce adapte les pluriels à la langue cible. Beaucoup de bibliothèques (rails-i18n, Hugo) n'utilisent encore que one et other pour l'espagnol : vérifiez ce que la vôtre attend avant de mettre le fichier en production.

Les variables %{name} et {name} sont contrôlées dans chaque valeur. L'ordre des mots change souvent : %{count} new messages devient %{count} mensajes nuevos, l'adjectif passant après le nom. C'est pourquoi une phrase complète avec variable se traduit bien, alors qu'une phrase reconstituée par concaténation de plusieurs clés donnera presque toujours un espagnol bancal.

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

Vous récupérez le même fichier, dans le même format, prêt à remettre dans le projet : indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM sont conservés. Seules les valeurs changent.

• Pour Rails, Symfony, Hugo et i18n-js, la clé racine de langue est gérée (en: devient es: quand le fichier en comporte une).
• Les ancres et alias (&defaults, *defaults), les blocs | et > et les commentaires restent en place.
• Chaque valeur traduite est comparée à la source (variables, balises). En cas d'écart persistant, la valeur source est gardée et le rapport le signale.
• Ne sont pas traduits : les clés, les valeurs vides, les URL, les adresses email, les nombres, les couleurs, les formats de date, les identifiants et tout ce qui est marqué non traduisible.

Le rapport livré avec le fichier liste les chaînes traduites et celles laissées telles quelles, avec la raison.

Ce que Manuce ne fait pas : adapter vos formats de date ou de nombre. Un %B %d, %Y reste tel quel, alors que l'usage espagnol est plutôt %d de %B de %Y ; à vous de le modifier. Le prix porte sur les mots des valeurs, clés et balises exclues, et l'espagnol est au tarif de base (coefficient ×1).

Préparer le fichier et vérifier le résultat

Avant le dépôt :

• Vérifiez que le fichier source se charge sans erreur : un YAML déjà cassé ne sera pas réparé par la traduction.
• Rassemblez les phrases découpées en plusieurs clés quand c'est possible, pour les raisons d'ordre des mots et de signes ¿ ¡ vues plus haut.
• Pour un nom de produit ou un terme qui doit rester en anglais, regardez comment il est rendu dans l'extrait gratuit, puis dans la traduction livrée.

Après la livraison :

• Rechargez le fichier avec votre outil habituel ou un validateur YAML, puis lancez l'application en espagnol.
• Testez les pluriels avec 0, 1 et 2 éléments.
• Passez sur les boutons et menus étroits, et sur les boîtes de dialogue qui posent une question.
• Réglez vous-même les séparateurs numériques : l'Espagne écrit 1.234,56, le Mexique 1,234.56.
• Enregistrez le fichier sous le nom attendu par votre outil, par exemple config/locales/es.yml (Rails), translations/messages.es.yaml (Symfony) ou i18n/es.yaml (Hugo).

En pratique

1. Vérifiez que votre fichier YAML source se charge sans erreur.
2. Déposez-le : le devis s'affiche aussitôt, calculé sur les mots des valeurs.
3. Choisissez l'espagnol et le niveau, puis contrôlez l'extrait gratuit (vocabulaire, tú ou usted).
4. Récupérez le fichier traduit et son rapport dans votre espace client.
5. Rechargez le fichier, testez les pluriels et les libellés longs, adaptez dates et séparateurs.