Traduire un fichier JSON i18n en russe

Ce que le russe change dans vos chaînes d'interface

Le russe s'écrit en cyrillique et prend plus de place que l'anglais ou le français : mots longs, déclinaisons, tournures plus développées. « Enregistrer » devient « Сохранить », « Paramètres du compte » devient « Настройки аккаунта ». Sur un libellé isolé, l'écart passe ; sur un onglet, un badge ou une colonne étroite, le texte déborde ou se coupe.

• Polices : si votre police web n'est chargée qu'avec le sous-ensemble latin, les lettres cyrilliques s'affichent en carrés ou basculent sur une police de secours d'un autre dessin. Vérifiez que le sous-ensemble cyrillique est bien inclus, pour chaque graisse utilisée.
• Majuscules : le russe ne met une capitale qu'au premier mot d'un titre ou d'un bouton. « Account Settings » ne donne pas « Настройки Аккаунта » mais « Настройки аккаунта ».
• Ponctuation : guillemets « » sans espaces intérieures, aucune espace avant « : ; ? ! », tiret long dans certaines phrases nominales (« Цена — 10 »).
• Nombres et dates : virgule décimale, espace comme séparateur de milliers, date au format 31.12.2025. Ces formats viennent de votre code, par exemple Intl.NumberFormat('ru'), et non du fichier de traduction.

Quatre formes de pluriel et des variables qui se déclinent

Le français et l'anglais se contentent de one et other. Le russe en demande quatre, selon la terminaison du nombre :

• one : 1, 21, 101 (mais pas 11) → « 1 файл » ;
• few : 2 à 4, 22 à 24 (mais pas 12 à 14) → « 3 файла » ;
• many : 0, 5 à 20, 25 à 30… → « 5 файлов » ;
• other : nombres fractionnaires → « 1,5 файла ».

Le message {count, plural, one {# fichier} other {# fichiers}} devient donc {count, plural, one {# файл} few {# файла} many {# файлов} other {# файла}}. Sans few ni many, la bibliothèque retombe sur other et affiche « 5 файла », une faute que tout lecteur russe remarque.

Les variables posent un second problème : le russe décline les noms et accorde le verbe passé en genre. Dans « Partager avec {name} », le prénom devrait passer à l'instrumental, ce qu'une variable ne permet pas. « {name} a modifié le fichier » exige un verbe au masculin (изменил) ou au féminin (изменила). Une formulation comme « Partagé avec : {name} », ou un message select sur le genre déjà présent dans la source, évite ces impasses.

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

Vous déposez le fichier JSON tel qu'il sort du projet, plat ou imbriqué, avec ses tableaux de chaînes. Vous récupérez le même fichier : indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM sont conservés ; seules les valeurs passent en russe.

• Les clés comme "cart.empty.title" ne sont jamais traduites.
• Les variables {name}, {{count}}, %s et les messages ICU (plural, select) sont vérifiés chaîne par chaîne : mêmes variables, autant de fois.
• Dans les messages ICU plural, les catégories few et many sont ajoutées.
• Valeurs vides, URL, adresses email, nombres, couleurs, formats de date, identifiants et tout ce qui est marqué non traduisible restent tels quels.
• Si une valeur traduite garde un écart avec la source (variable manquante, balise perdue), la valeur source est conservée et le rapport le signale.

Le rapport liste les chaînes traduites et celles laissées telles quelles, avec la raison. Comme seules les valeurs changent, aucune clé n'est ajoutée : si votre projet gère les pluriels par suffixes de clés à la façon d'i18next (_one, _other), les clés _few et _many sont à créer de votre côté. Le rendu dans l'interface reste aussi à vérifier par vous. Le russe est une langue à supplément : coefficient ×1,25 sur le prix au mot, compté sur les seules valeurs.

Préparer le fichier avant l'envoi

• Encodage : enregistrez le fichier en UTF-8. L'encodage d'origine est conservé tel quel ; mieux vaut qu'il puisse porter le cyrillique.
• Phrases entières : préférez un message complet "items": "{count, plural, …}" à deux fragments "prefix": "Vous avez" et "suffix": "articles". Le russe accorde le nom avec le nombre ; deux morceaux traduits séparément ne peuvent pas l'être.
• Place des variables : évitez de glisser {name} ou {city} au milieu d'une phrase où le mot changerait de cas ; placez-les après deux-points ou en fin de libellé.
• Noms à garder en latin : pour une marque ou un nom de produit qui doit rester tel quel, vérifiez son traitement dans l'extrait gratuit, puis dans la traduction livrée.
• Volume : seuls les mots des valeurs sont comptés ; des clés longues et très imbriquées n'alourdissent pas le devis.

Vérifier le résultat dans l'application

1. Lisez le rapport : une chaîne restée dans la langue source correspond à une valeur non traduisible ou à un écart de variable ou de balise que la traduction n'a pas résolu.
2. Testez les pluriels avec 1, 2, 5, 11, 21 et 22 : vous devez voir « файл », « файла », « файлов », « файлов », « файл », « файла ».
3. Parcourez les écrans étroits (menus, boutons, onglets, notifications mobiles) pour repérer débordements et coupures ; prévoyez un retour à la ligne ou une troncature avec infobulle.
4. Vérifiez la police dans toutes ses graisses : un gras chargé sans glyphes cyrilliques retombe sur une autre police.
5. Contrôlez le registre : une interface russe s'adresse en général à l'utilisateur par « вы ». L'extrait gratuit vous montre le ton avant de payer.

En pratique

1. Déposez le fichier JSON source en UTF-8 et choisissez le russe : le devis s'affiche, calculé sur les mots des valeurs.
2. Lisez l'extrait gratuit pour juger le ton et le traitement des noms de marque.
3. Payez, puis récupérez le fichier russe et son rapport dans votre espace client.
4. Placez le fichier dans le projet (par exemple ru.json), créez au besoin les clés _few et _many, puis testez pluriels et écrans étroits.