Traduire un fichier YAML en russe, pluriels et clés compris

Ce que le russe change dans vos chaînes

Le russe s'écrit en cyrillique, se lit de gauche à droite et donne en général un texte plus long que l'anglais. Dans un fichier YAML d'interface, ce sont surtout les libellés courts qui en pâtissent : save: Save devient save: Сохранить, et un bouton prévu pour quatre lettres en reçoit neuf.

Trois points demandent une attention particulière :

• Le genre au passé. Une chaîne comme "%{name} a modifié le document" exige en russe un verbe accordé au genre de la personne : изменил au masculin, изменила au féminin. La variable ne porte pas cette information. Vérifiez la formulation retenue et décidez si votre produit préfère une tournure neutre.
• Les cas. Le russe décline les noms, mais une valeur insérée par %{name} arrive telle que votre base la fournit, au nominatif. Une phrase comme « Message de %{name} » se rend plus sûrement en plaçant la variable après deux-points : Отправитель: %{name}.
• Le registre. Une interface s'adresse le plus souvent à l'utilisateur au vouvoiement (вы, parfois avec majuscule dans les messages personnels) ; le tutoiement (ты) se rencontre dans des produits grand public au ton familier. L'extrait gratuit montre le registre obtenu avant de payer.

La ponctuation russe a aussi ses règles : guillemets « », aucune espace avant les deux-points ou le point d'interrogation, tiret long pour les incises. Dans une valeur YAML entre guillemets doubles, les « » russes ne posent aucun problème d'échappement.

Pluriels : de deux clés à quatre

Une source anglaise ou française n'a souvent que one et other. Le russe en utilise quatre selon CLDR : one, few, many, other. Manuce adapte le bloc de pluriel à la langue cible. Pour un compteur de fichiers :

• one: "%{count} файл" : 1, 21, 101
• few: "%{count} файла" : 2 à 4, 22 à 24
• many: "%{count} файлов" : 0, 5 à 20, 25 à 30
• other: "%{count} файла" : nombres décimaux, comme 1,5

Le piège classique : 11 à 14 relèvent de many, pas de one ni de few, alors que 21 revient à one. Une règle maison du type « 1 = singulier, sinon pluriel » produit donc des fautes visibles.

Ajouter les clés dans le fichier ne suffit pas toujours : la bibliothèque doit savoir les choisir. Sous Rails, le module i18n de base ne connaît que one et other ; une règle de pluriel russe doit être chargée, par exemple via la gem rails-i18n. Hugo s'appuie sur les catégories CLDR et lit directement les quatre clés. Avec i18n-js, vérifiez que la configuration côté JavaScript connaît la règle russe, sinon few et many ne seront jamais affichés.

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

Vous recevez le même fichier YAML, prêt à remettre dans le projet. Seules les valeurs changent : indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM sont conservés. Pour Rails, Symfony, Hugo et i18n-js, la clé racine de langue est gérée (le en: de tête d'un fichier Rails devient ru:), et les ancres, les blocs | et > et les commentaires restent en place.

• Les variables %{name} et {name} sont vérifiées : chaque valeur traduite est comparée à la source, variables et balises comprises. 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 comme "%d.%m.%Y", les identifiants et tout ce qui est marqué non traduisible.
• Le rapport liste les chaînes traduites et celles laissées telles quelles, avec la raison.

Manuce ne compile pas votre application et ne teste pas l'affichage : il ne voit ni la largeur de vos boutons ni la police chargée, et ne connaît pas le genre de la personne derrière une variable. Le prix porte sur les mots des valeurs, clés et balises exclues, avec un coefficient de ×1,25 pour le russe.

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

• Encodage. L'encodage du fichier est conservé : déposez donc un fichier en UTF-8. Un fichier en Latin-1 ou Windows-1252 ne peut pas contenir de caractères cyrilliques.
• Nom du fichier. Symfony et Hugo déduisent la langue du nom : enregistrez la version rendue sous messages.ru.yaml ou i18n/ru.yaml selon votre arborescence.
• Termes à garder. Nom de produit, marque, terme technique : vérifiez dans l'extrait gratuit, puis dans la traduction, qu'ils sont restés en caractères latins s'ils doivent l'être.
• Polices. Une police web limitée au sous-ensemble latin affiche des carrés ou bascule sur une police de secours. Vérifiez que le sous-ensemble cyrillique est bien chargé.
• Validation. Passez le fichier rendu dans votre parseur ou votre linter YAML habituel, lancez l'application en ru et testez les compteurs avec 1, 2, 5, 11 et 21.
• Dates sous Rails. Les mois russes changent de forme selon le contexte (январь seul, 15 января dans une date). Les traductions de rails-i18n couvrent déjà ce cas ; mieux vaut s'appuyer dessus que réécrire ces clés.

En pratique

1. Convertissez le fichier en UTF-8 si besoin, puis déposez-le : le devis s'affiche aussitôt, calculé sur les mots des valeurs.
2. Choisissez le niveau et lisez l'extrait gratuit : registre, termes à garder, variables.
3. Payez, puis récupérez dans votre espace client le fichier YAML traduit et son rapport.
4. Nommez le fichier pour la locale ru, chargez la règle de pluriel russe si votre bibliothèque l'exige, puis testez compteurs et affichage.