Traduire un fichier CSV de chaînes en portugais

Brésil ou Portugal : deux colonnes, deux vocabulaires

Manuce traite le portugais du Brésil et le portugais européen comme deux langues distinctes. Dans une table de chaînes d'interface, ce choix n'est pas un détail : les mots les plus fréquents d'un menu changent d'un pays à l'autre.

• Save : Salvar au Brésil, Guardar au Portugal
• File : Arquivo / Ficheiro
• Screen : Tela / Ecrã
• Settings : Configurações / Definições

L'adresse au joueur ou à l'utilisateur diffère aussi : le Brésil emploie você avec les formes verbales de la troisième personne, le Portugal recourt plus volontiers au tu dans un registre familier ou à des tournures impersonnelles. Une interface qui mélange les deux sonne faux pour les deux publics.

L'en-tête de la colonne doit refléter ce choix. Selon le projet, le moteur attend pt_BR, pt-BR, pt_PT ou simplement pt. Si la colonne de la langue cible existe, Manuce la remplit ; sinon, il l'ajoute en dernière colonne. Dans les deux cas, contrôlez à la livraison que l'en-tête de la colonne remplie correspond au code exact que lit votre moteur. Si vous visez les deux marchés, commandez les deux langues : chacune est traduite dans sa variante, et la remise multilingue s'applique à toute la commande.

Ce que le portugais change dans vos valeurs

Longueur. Le portugais est nettement plus long que l'anglais : Sound volume devient Volume do som, Sound effects volume devient Volume dos efeitos sonoros. Les boutons à largeur fixe, les onglets et les cases du HUD sont les premiers à déborder.

Accords et variables. L'anglais Welcome, {name} est neutre ; le portugais doit choisir entre Bem-vindo et Bem-vinda. La traduction ne peut pas deviner le genre que portera la variable : si votre jeu gère ce cas, prévoyez deux clés, ou précisez l'usage dans la colonne context. L'ordre des mots change également : {player}'s sword devient a espada de {player}. La variable est déplacée, jamais modifiée.

Pluriels. Le portugais compte trois catégories CLDR : one, many et other. many concerne les multiples exacts du million, qui appellent la préposition de (1 milhão de moedas). Autre piège : selon CLDR, le zéro relève de one en portugais du Brésil et de other en portugais européen. Un CSV n'a pas de structure de pluriel propre : si vous utilisez des clés comme coins_one et coins_other, chacune est traduite, mais aucune clé coins_many n'est créée.

Caractères. ã, õ, ç, á, ê, à apparaissent dans presque toutes les chaînes (Opções, Começar, Não). Le fichier rendu garde l'encodage et le BOM d'origine : un CSV en UTF-8 les reçoit sans difficulté.

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

Vous récupérez le même fichier CSV, 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 changent.

• Contexte. Une colonne comment ou context sert à lever les ambiguïtés : Play se dit Jogar pour un jeu et Reproduzir pour une vidéo ; Back se traduit Voltar sur un bouton.
• Laissé tel quel. Clés, valeurs vides, URL, adresses email, nombres, couleurs (#FF8800), formats de date (dd/MM/yyyy), identifiants et tout ce qui est marqué non traduisible.
• Contrôle. Chaque valeur traduite est comparée à la source : variables ({0}, %d) et balises (<color=red>). En cas d'écart persistant, la valeur source est gardée et le rapport le signale.
• Rapport. Chaînes traduites, chaînes laissées telles quelles et raison.

Ce que Manuce ne fait pas : il ne connaît pas la largeur de vos boutons et ne teste pas le rendu dans le moteur ; il n'ajoute pas de clés manquantes ; il ne reçoit ni glossaire ni consignes de terminologie. Pour un nom de personnage ou de produit à garder tel quel, vérifiez-le dans l'extrait gratuit puis dans la traduction. Un CSV sans colonne de clés n'est pas considéré comme un fichier de langue : il est traduit comme un texte. Le prix porte sur les mots des valeurs, clés et balises exclues, avec un coefficient ×1 pour le portugais.

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

Avant l'envoi :

• Vérifiez la présence d'une colonne de clés (keys dans Godot, Key ou Id ailleurs) et d'une colonne source remplie.
• Enregistrez en UTF-8, pour que les caractères portugais passent partout.
• Renseignez la colonne context pour les libellés courts et ambigus : Save, Play, Back, Free (Grátis ou Livre).
• Ajoutez vous-même les clés de pluriel attendues par votre code, par exemple coins_many, avec le texte source.

Après la livraison :

• Évitez d'ouvrir et de réenregistrer le fichier dans un tableur : un tableur réglé en portugais ou en français peut remplacer les virgules par des points-virgules et changer l'encodage.
• Vérifiez que la police du jeu couvre ã, õ, ç : un atlas de police limité aux caractères ASCII affichera des carrés vides.
• Parcourez les écrans les plus chargés pour repérer les débordements.
• Lisez le rapport : une chaîne restée en langue source signale souvent une variable mal fermée dans l'original.

En pratique

1. Vérifiez que le CSV a une colonne de clés et enregistrez-le en UTF-8.
2. Déposez-le, choisissez portugais du Brésil ou portugais européen et lisez l'extrait gratuit.
3. Récupérez le fichier et le rapport, puis contrôlez l'en-tête de la colonne portugaise.
4. Réimportez le CSV dans Unity ou Godot et testez les écrans les plus chargés.