Traduire un fichier YAML en arabe

Ce que l’arabe change dans un fichier YAML

Le fichier lui-même ne change pas de structure : seules les valeurs passent en arabe. Mais trois points demandent une attention particulière.

• Le pluriel à six formes. Là où l’anglais ou le français se contentent de one et other, l’arabe distingue zero, one, two, few (3 à 10), many (11 à 99) et other. Un bloc items: { one: "%{count} item", other: "%{count} items" } devient par exemple zero: "لا توجد عناصر", one: "عنصر واحد", two: "عنصران", few: "%{count} عناصر", many: "%{count} عنصرًا", other: "%{count} عنصر". Le nom change de forme selon le nombre : ce n’est pas un simple « s » à ajouter.
• Le sens droite à gauche. Dans le fichier, le texte est enregistré dans l’ordre logique. Quand une valeur mêle arabe et variable latine, comme "مرحبًا %{name}", votre éditeur peut afficher la variable à un endroit qui semble faux : c’est un effet d’affichage, pas une erreur. Ne déplacez pas la variable à la main.
• La ponctuation propre à l’arabe. La virgule ،, le point-virgule ؛ et le point d’interrogation ؟ remplacent leurs équivalents latins dans le texte traduit.

Ce que Manuce vous rend exactement

Vous récupérez le même fichier, dans le même format, prêt à remettre dans le projet sous le nom ar.yml ou celui qu’utilise votre cadriciel.

• La clé racine de langue est gérée pour Rails, Symfony, Hugo et i18n-js : en: ou fr: devient ar:.
• Indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM sont conservés. Les ancres (&defaults, *defaults) et les blocs | et > 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 comme #1A73E8, les formats de date comme %d/%m/%Y, 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 : il ne touche pas à la mise en page de votre application. L’affichage de droite à gauche (attribut dir="rtl", inversion des marges, icônes fléchées) reste à régler côté code. Manuce ne choisit pas non plus entre chiffres occidentaux et chiffres arabo-indiens (٣ au lieu de 3) : les nombres ne sont pas traduits, leur affichage dépend du formatage de votre application.

Pluriels arabes : vérifier que votre projet suit

Un fichier qui contient les six formes ne sert à rien si la bibliothèque d’internationalisation n’en lit que deux. Avant de mettre le fichier en production, vérifiez que votre pile applique bien les règles de pluriel de l’arabe.

• Rails : la gestion de base ne connaît que one et other ; les règles de l’arabe s’ajoutent par un module de pluriel, souvent via la gemme rails-i18n.
• Hugo s’appuie sur les catégories CLDR : les clés zero à other sont attendues telles quelles.
• Symfony et i18n-js : contrôlez la syntaxe de pluriel employée dans vos chaînes et la règle déclarée pour ar.

Testez ensuite un même libellé avec les valeurs 0, 1, 2, 5, 15 et 100 : chacune doit afficher une forme différente. C’est le test le plus rapide pour repérer une forme manquante.

Préparer le fichier avant de le déposer

• Enregistrez-le en UTF-8. Manuce conserve l’encodage d’origine ; un fichier en Latin-1 ne peut pas contenir de lettres arabes. Convertissez-le avant le dépôt.
• Marquez ce qui ne doit pas bouger. Un nom de produit ou une valeur technique doit être marqué non traduisible. Pour un terme que vous voulez garder tel quel, vérifiez l’extrait gratuit puis la traduction livrée.
• Pensez au registre. Une interface en arabe s’écrit en général en arabe standard moderne, pas en dialecte. L’arabe accorde aussi verbes et adjectifs au genre : un libellé comme "Welcome back" s’adresse à un homme ou à une femme. Si vos valeurs supposent l’un ou l’autre, jugez-en sur l’extrait.
• Contrôlez les chaînes construites par morceaux. Une phrase assemblée à partir de plusieurs clés ("%{a} " + t("and") + " %{b}") se traduit mal dans une langue où l’ordre des mots diffère. Mieux vaut une seule valeur avec variables.

L’arabe est une langue à supplément : un coefficient ×1,6 s’applique au prix au mot, calculé sur les seuls mots des valeurs, clés et balises exclues.

Vérifier le fichier traduit

1. Lisez le rapport : une valeur laissée en source signale souvent une variable mal placée dans l’original.
2. Chargez le fichier dans votre application et affichez quelques écrans avec la langue ar active.
3. Regardez les valeurs mêlant arabe et éléments latins (%{count}, noms de marque, codes) dans l’interface, avec le sens droite à gauche activé, plutôt que dans l’éditeur.
4. Vérifiez les boutons et les colonnes étroites : les lettres arabes liées et leurs signes occupent plus de hauteur, et la longueur des libellés varie.

En pratique

1. Enregistrez votre fichier YAML en UTF-8 et marquez les valeurs non traduisibles.
2. Déposez-le sur Manuce : le devis s’affiche aussitôt, sur les mots des valeurs.
3. Lisez l’extrait gratuit en arabe au niveau choisi.
4. Récupérez le fichier ar.yml et son rapport.
5. Testez les pluriels et l’affichage droite à gauche dans votre application.