Traduire un fichier CSV de chaînes en anglais

Ce que Manuce lit dans votre CSV

Un CSV de chaînes « développeur » se reconnaît à sa structure : une colonne de clés (key, id, keys…) puis une colonne par langue (fr, en, de_DE…), comme dans les tables de localisation d’Unity ou les fichiers de traduction de Godot. Par exemple :

• keys,fr,en
• MENU_QUIT,Quitter la partie ?,
• HUD_SCORE,Score : {0},

Si la colonne en existe, elle est remplie ; si elle n’existe pas, elle est ajoutée en dernière colonne. Une colonne comment ou context sert de contexte : une note comme « bouton, 12 caractères max » ou « verbe, pas nom » aide à trancher entre Open et Opening, ou entre Save et Saving. Elle n’est pas traduite pour autant.

Un CSV sans colonne de clés (un export de tableur, une liste de produits) n’est pas un fichier de langue : il est alors traduit comme un texte, cellule par cellule, sans la logique de colonnes décrite ici.

Du français à l’anglais : ce qui change dans les chaînes

L’anglais est en général 10 à 15 % plus court que le français : les débordements de boutons sont rares dans ce sens, mais d’autres points demandent votre attention.

• Ponctuation : l’espace avant « : ; ? ! » disparaît. Score : {0} devient Score: {0}, Quitter la partie ? devient Quit the game?. Les guillemets « » deviennent des guillemets anglais.
• Tu, vous et l’accord : Es-tu prêt ?, Êtes-vous prête ? et Prêt·e ? donnent tous Ready?. Si vous aviez dupliqué des clés pour le genre du joueur (WELCOME_M, WELCOME_F), les deux valeurs anglaises seront souvent identiques.
• Pluriels : l’anglais n’a que deux catégories CLDR, one et other. Piège classique : zéro est au singulier en français (0 pièce) mais au pluriel en anglais (0 coins). Si votre code choisit la clé _ONE pour 0 et 1 selon la règle française, l’anglais affichera 0 coin.
• Britannique ou américain : colour ou color, favourite ou favorite, Cancelled ou Canceled. Vérifiez la variante retenue dans l’extrait gratuit avant de payer.
• Majuscules : les menus anglais hésitent entre Save as et Save As. Repérez le choix dans l’extrait et harmonisez si votre charte en impose un autre.

Variables, balises et valeurs qui ne bougent pas

Les chaînes de jeu et d’application mélangent texte et code. Chaque valeur traduite est comparée à la source : {0}, {player_name}, %s, %d, les balises BBCode de Godot ([b], [color=red]) ou le texte enrichi d’Unity (<color=#FF0000>, <b>) doivent se retrouver dans la version anglaise. L’ordre peut changer, ce qui est normal : {0} a vaincu {1} peut devenir {1} was defeated by {0}.

En cas d’écart persistant (une variable perdue, une balise mal fermée), la valeur source est gardée et le rapport le signale : mieux vaut une ligne en français repérée qu’une chaîne anglaise qui fait planter l’affichage.

Ne sont pas traduits : les clés, les valeurs vides, les URL, les adresses email, les nombres, les couleurs (#FFAA00), les formats de date, les identifiants et tout ce qui est marqué non traduisible. Conséquence pratique : une valeur dd/MM/yyyy reste telle quelle. Si votre version anglaise vise un public américain qui lit MM/dd/yyyy, c’est à vous de modifier ce format.

Ce que vous recevez, et ce que Manuce ne fait pas

Vous récupérez le même fichier, dans le même format, prêt à remettre dans le projet : ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM sont conservés ; seules les valeurs de la colonne anglaise changent. Une valeur comme "Attaque, défense", protégée par des guillemets parce qu’elle contient une virgule, garde ses guillemets en anglais. S’y ajoute un rapport : chaînes traduites, chaînes laissées telles quelles et pourquoi.

Le prix porte sur les mots des valeurs, clés et balises exclues ; l’anglais est au tarif de base (coefficient ×1). Ce que Manuce ne fait pas :

• il ne reçoit ni glossaire ni mémoire de traduction : pour un nom propre ou un terme maison (Forgeron, Pierre d’âme) à garder ou à rendre d’une certaine façon, vérifiez l’extrait puis la traduction ;
• il ne crée pas de clés de pluriel absentes de votre fichier et ne modifie pas votre logique de sélection ;
• il ne teste pas l’affichage dans le moteur : la longueur réelle à l’écran reste à contrôler.

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

1. Vérifiez l’en-tête : la colonne de clés doit être identifiable et la colonne cible nommée comme votre moteur l’attend (en, en_GB, en_US). Si elle manque, elle sera ajoutée en fin de ligne.
2. Contrôlez le séparateur : un tableur réglé en français exporte souvent avec des points-virgules, alors que Godot attend des virgules. Corrigez avant le dépôt, le fichier vous sera rendu avec la même structure.
3. Remplissez la colonne de contexte pour les mots ambigus en anglais : Play (verbe ou nom), Close (fermer ou proche), Light (lumière ou léger).
4. Après livraison, ne rouvrez pas le fichier dans un tableur qui pourrait changer l’encodage ; importez-le directement et lisez le rapport pour traiter les valeurs restées en français.
5. Testez les écrans avec pluriels et variables, notamment le cas zéro.

En pratique

1. Vérifiez que votre CSV a une colonne de clés et, si possible, une colonne de contexte.
2. Déposez le fichier : le devis est calculé sur les mots des valeurs.
3. Lisez l’extrait gratuit (orthographe britannique ou américaine, majuscules, termes maison).
4. Payez et récupérez le CSV avec sa colonne anglaise et le rapport.
5. Réimportez le fichier dans Unity ou Godot et testez pluriels et variables.