Traduire un fichier CSV de chaînes en arabe

Ce que l'arabe change dans une table de chaînes

Un CSV stocke le texte dans l'ordre logique, celui de la frappe. L'arabe s'écrit de droite à gauche et ses lettres se lient : la forme de chaque lettre dépend de sa position dans le mot. Le fichier contient donc des caractères de base, et c'est le moteur de rendu de votre application qui les assemble et les aligne à droite. Ouvert dans un éditeur de texte ordinaire, un CSV arabe peut sembler en désordre, surtout quand une ligne mêle clé latine, séparateurs et texte arabe : ce n'est pas une erreur du fichier, et il ne faut pas le « corriger » à la main.

• Ponctuation : l'arabe a sa virgule ،, son point-virgule ؛ et son point d'interrogation ؟. Ce sont des caractères distincts du séparateur du CSV. La chaîne Welcome, {player}! devient par exemple مرحبًا، {player}!.
• Variables dans une phrase de droite à gauche : {0}, %d ou {player} restent en caractères latins au milieu du texte arabe. Leur place dans la phrase change souvent (Level {0} → المستوى {0}), et l'affichage peut les déplacer visuellement quand elles touchent un signe de ponctuation.
• Genre de l'utilisateur : l'impératif arabe s'accorde au masculin ou au féminin. Les interfaces préfèrent souvent le nom d'action, neutre : « Save » se rend par حفظ (sauvegarde) plutôt que par un impératif.
• Chiffres : le Maghreb emploie les chiffres 0-9, le Machrek et le Golfe souvent les chiffres arabes orientaux ٠١٢٣. C'est un réglage de formatage côté application, pas une question de traduction des chaînes.

Six formes de pluriel pour une table à une ligne par forme

Un CSV n'a pas de structure de pluriel : chaque forme est une ligne, distinguée par sa clé, par exemple files_count_one et files_count_other pour une source anglaise ou française. L'arabe en demande six (zero, one, two, few, many, other), et la forme du nom change réellement :

• zero : لا توجد ملفات (aucun fichier)
• one : ملف واحد
• two : ملفان (le duel, sans chiffre)
• few (3 à 10) : {0} ملفات
• many (11 à 99) : {0} ملفًا
• other (100, 1000…) : {0} ملف

Manuce traduit les valeurs des lignes existantes et n'ajoute pas de clé. Si votre table ne contient que _one et _other, la colonne arabe aura deux traductions, et un compteur à 11 affichera la forme « other », grammaticalement fausse. Pour un résultat juste, créez les lignes manquantes avant l'envoi, avec le texte source recopié et une indication dans la colonne de contexte (« pluriel, 3 à 10 »), puis vérifiez que votre moteur sait choisir parmi les six catégories.

Ce que Manuce rend exactement

Manuce reconnaît un CSV « développeur » à sa colonne de clés (key, id…) suivie de colonnes de langue (en, fr, de_DE…), comme dans Unity ou Godot.

• Si une colonne ar existe, elle est remplie ; sinon elle est ajoutée en dernière colonne.
• Une colonne comment ou context sert de contexte : c'est là que vous indiquez qu'une chaîne est un bouton, un titre ou un compteur.
• Le reste du fichier ne bouge pas : ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM. Seules les valeurs changent.
• Chaque valeur arabe est comparée à la source : si {player} ou une balise <b> manque ou diffère et que l'écart persiste, la valeur source est gardée et le rapport le signale.
• Ne sont pas traduits : clés, valeurs vides, URL, adresses email, nombres, couleurs, formats de date, identifiants, et ce qui est marqué non traduisible.

Vous recevez le même fichier, prêt à réimporter, et un rapport listant les chaînes traduites et celles laissées telles quelles, avec la raison. Manuce ne crée pas de clés de pluriel et ne règle ni l'affichage de droite à gauche ni les polices de votre application. Un CSV sans colonne de clés n'est pas traité comme un fichier de langue : il est traduit comme un texte.

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

1. Encodage : l'arabe exige un encodage Unicode. Un CSV en Windows-1252 ou Latin-1 ne peut pas contenir de lettres arabes ; enregistrez-le en UTF-8 avant l'envoi. Encodage et BOM étant conservés, c'est votre fichier source qui décide. Un tableur peut afficher un UTF-8 sans BOM en caractères illisibles alors que le fichier est correct : jugez plutôt dans votre moteur.
2. Nom de colonne : si votre moteur attend ar, ar_SA ou ar_EG, créez la colonne vide avec ce nom ; elle sera remplie sous cet en-tête.
3. Contexte : renseignez la colonne de contexte pour les chaînes courtes et ambiguës (« Open » : verbe ou état ? « Back » : retour ou dos ?), et pour le genre quand une chaîne s'adresse à un personnage ou à un joueur précis.
4. Termes à garder : un nom de jeu ou de produit qui doit rester en caractères latins se vérifie sur l'extrait gratuit, puis dans la traduction livrée.
5. Test dans le moteur : importez la table et parcourez quelques écrans. Vérifiez que les lettres sont liées, que le texte est aligné à droite, que la police contient les glyphes arabes et que les signes diacritiques (ً dans مرحبًا) ne sont pas coupés en haut ou en bas des zones de texte.

En pratique

1. Enregistrez le CSV en UTF-8 et vérifiez qu'il a bien une colonne de clés (key, id…).
2. Ajoutez si besoin la colonne arabe sous le nom attendu par votre moteur (ar, ar_SA…) et complétez la colonne de contexte, y compris pour les lignes de pluriel.
3. Déposez le fichier : devis immédiat sur les mots des valeurs, extrait gratuit avant de payer.
4. Récupérez le fichier et le rapport, puis reprenez les chaînes laissées en langue source.
5. Importez la table et testez l'affichage : lettres liées, alignement à droite, police, pluriels.