Traduire un fichier YAML en chinois simplifié

Ce qui change quand un YAML passe en chinois

Le chinois simplifié s'écrit sans espaces entre les mots et avec une ponctuation pleine chasse : ，。：！？. Pour YAML, c'est plutôt une bonne nouvelle : seul le deux-points ASCII suivi d'une espace a un sens syntaxique, le deux-points chinois ： ne casse rien. Une valeur comme notice: 保存成功：已更新 3 项 reste valide.

Le texte est deux à trois fois plus court en caractères, mais chaque caractère est plus large : la place occupée à l'écran varie peu. En revanche, toute limite exprimée en nombre de caractères (un maxlength, une troncature à 40 caractères) laissera passer beaucoup plus de sens qu'en français, ou coupera au milieu d'un mot de deux caractères.

Le pluriel n'existe pas en grammaire chinoise : la seule catégorie CLDR est other. À la place, le nombre est suivi d'un classificateur : %{count} 条消息 (messages), %{count} 个文件 (fichiers), %{count} 张图片 (images). La variable change souvent de place : « Vous avez %{count} nouveaux messages » devient 您有 %{count} 条新消息.

Enfin, une police latine n'a pas les caractères chinois. Si votre feuille de style ne déclare qu'une police web latine, le navigateur basculera sur une police système, parfois mal assortie : prévoyez une police de secours chinoise.

Rails, Symfony, Hugo : clé racine, pluriels et blocs

Dans un fichier Rails ou i18n-js, tout commence par la clé de langue, par exemple fr: en tête de fichier. Manuce gère cette clé racine ; vérifiez seulement que le code obtenu est celui qu'attend votre projet (zh-CN, zh ou zh-Hans selon vos conventions) et nommez le fichier en conséquence, par exemple messages.zh_CN.yaml pour Symfony, ou selon le code de langue déclaré dans la configuration de Hugo.

Les pluriels sont adaptés à la langue cible : un bloc one: / other: se réduit à la seule forme other. Côté Rails, assurez-vous que votre application connaît la règle de pluriel chinoise (la gemme rails-i18n la fournit, par exemple) ; sans elle, le moteur cherche la clé one quand count vaut 1.

Les ancres (&defaults, *defaults) et les commentaires sont conservés. Attention aux blocs repliés > : YAML y transforme chaque saut de ligne en espace. Une phrase chinoise répartie sur deux lignes s'affichera donc avec une espace parasite entre deux caractères, ce qui passe inaperçu en français mais se voit en chinois. Le bloc littéral |, lui, garde les sauts de ligne tels quels.

Ce que Manuce rend, et ce qu'il laisse de côté

Vous récupérez le même fichier : indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM conservés. Seules les valeurs changent : title: "Enregistrer" devient title: "保存", guillemets compris.

Chaque valeur traduite est comparée à la source : les variables %{name} et {name} et les balises doivent s'y retrouver. Si une valeur chinoise perd une variable et que l'écart persiste, la valeur source est gardée et le rapport le signale : mieux vaut une chaîne en langue source visible qu'une interpolation cassée.

Ne sont pas traduits : les clés, les valeurs vides, les URL, les adresses email, les nombres, les couleurs, les identifiants, les formats de date et tout ce qui est marqué non traduisible. Conséquence concrète pour le chinois : un format comme long: "%d %B %Y" reste tel quel. L'ordre chinois habituel, %Y年%m月%d日, est à saisir vous-même dans la section date.formats.

Manuce ne reçoit ni glossaire ni consignes de style. Le registre (您, vouvoiement, ou 你, plus familier) et le traitement d'un nom de produit se vérifient donc sur l'extrait gratuit. Le chinois traditionnel (Taïwan, Hong Kong) est une langue distincte, à commander à part. Le devis porte sur les mots des valeurs, clés et balises exclues, avec le coefficient ×1,6 du chinois.

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

• Encodage : il est conservé tel quel, partez donc d'un fichier en UTF-8. Un YAML resté en Latin-1 ne peut pas contenir de caractères chinois.
• Validité : chargez le fichier source dans votre projet ou un validateur YAML avant de le déposer ; une erreur de syntaxe se retrouverait à l'identique dans la version chinoise.
• Phrases découpées : si une phrase est assemblée à partir de deux clés (prefix puis suffix), l'ordre des mots chinois ne suivra pas. Une seule clé avec variable donne un résultat bien plus naturel.
• Après livraison : lisez le rapport, repérez les valeurs restées en langue source, testez un écran avec count à 0, 1 et 5, et cherchez les espaces parasites dans les blocs >.
• Affichage : vérifiez que la police de secours affiche bien les hanzi et qu'aucun bouton ne coupe un mot en deux.

En pratique

1. Vérifiez que votre YAML source est en UTF-8 et se charge sans erreur.
2. Déposez-le : le devis compte les mots des valeurs, clés exclues.
3. Lisez l'extrait gratuit : registre, noms de produit, classificateurs.
4. Récupérez le fichier chinois et son rapport des chaînes.
5. Nommez le fichier selon le code attendu, ajustez date.formats et testez.