Traduire un fichier YAML en portugais (Brésil ou Portugal)

Brésil ou Portugal : un choix à faire avant le dépôt

Le portugais du Brésil et le portugais européen sont deux langues cibles distinctes chez Manuce. Choisissez celle de vos utilisateurs, ou commandez les deux. La différence ne se limite pas à quelques accents : elle touche le vocabulaire même d'une interface.

• file : arquivo (BR), ficheiro (PT)
• screen : tela (BR), ecrã (PT)
• user : usuário (BR), utilizador (PT)
• save : Salvar (BR), Guardar (PT)
• download : Baixar (BR), Transferir (PT)

La façon de s'adresser à l'utilisateur change aussi. Au Brésil, você domine, avec un verbe à la troisième personne : « Você tem 3 mensagens novas ». Au Portugal, le tu est courant dans un ton familier, et les interfaces contournent souvent la question avec l'infinitif sur les boutons, comme « Guardar alterações ». Un écran qui mélange les deux variantes se remarque tout de suite. Gardez donc une seule variante par fichier de langue.

Côté structure, la clé racine de langue est gérée pour Rails, Symfony, Hugo et i18n-js. Vérifiez seulement que le code de langue et le nom du fichier correspondent à ce que votre projet attend. Selon l'outil, on rencontre pt, pt-BR, pt_BR ou pt-PT.

Pluriels, zéro, genre et longueur : les pièges du portugais

La norme CLDR prévoit trois catégories de pluriel pour le portugais : one, many et other. Dans un fichier Rails ou i18n-js, on ne rencontre presque toujours que one et other. La catégorie many concerne surtout les très grands nombres ronds, où le portugais ajoute de : « 1 milhão de usuários ». Les pluriels sont adaptés à la langue cible.

Le zéro est un piège propre au portugais. Selon CLDR, le portugais du Brésil range 0 dans one, ce que ne fait pas le portugais européen. Avec one: "%{count} arquivo excluído" et other: "%{count} arquivos excluídos", un compte à zéro affichera donc « 0 arquivo excluído » en pt-BR. Vous préférez « Nenhum arquivo excluído » ? Ajoutez une clé zero: dans la source : le backend i18n par défaut de Rails l'utilise lorsque le compte vaut 0.

Le genre pose un autre problème, car le portugais accorde adjectifs et participes. « Bem-vindo, %{name} » est au masculin ; pour une utilisatrice, il faudrait « Bem-vinda ». La variable est conservée, mais rien ne dit qui elle désigne. Il en va de même pour %{item} foi excluído, qui devient excluída si l'objet est féminin (a pasta). Repérez ces formules dans la traduction et, au besoin, reformulez la source de façon neutre avant le dépôt.

Enfin, le portugais est nettement plus long que l'anglais et proche du français : « Settings » devient « Configurações » (BR) ou « Definições » (PT). Prévoyez de la place dans les boutons et les onglets.

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

Vous récupérez le même fichier YAML, dans le même format, prêt à remettre dans le projet. Seules les valeurs changent. L'indentation, l'ordre des clés, les guillemets, les commentaires, les fins de ligne, l'encodage et le BOM sont conservés. Les ancres (&defaults, <<: *defaults) et les blocs | et > restent en place.

Certains éléments ne sont pas traduits : les clés, les valeurs vides, les URL, les adresses email, les nombres, les couleurs, les formats de date, les identifiants et tout ce qui est marqué non traduisible. Les variables %{name} et {name} sont vérifiées, car chaque valeur traduite est comparée à la source (variables, balises). En cas d'écart persistant, la valeur source est gardée et le rapport le signale.

Ce rapport accompagne le fichier. Il liste les chaînes traduites, les chaînes laissées telles quelles et la raison. Le prix porte sur les mots des valeurs, clés et balises exclues. Pour des chaînes visibles par vos clients, le niveau Professionnel correspond à un texte prêt à transmettre.

Ce que Manuce ne fait pas : il ne reçoit ni glossaire ni mémoire de traduction, et il ne modifie pas les formats de date. Un default: "%m/%d/%Y" à l'américaine reste tel quel. Or le Brésil comme le Portugal attendent %d/%m/%Y : cette modification est à faire vous-même.

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

• Encodage : le portugais emploie partout ã, õ, ç, ê ou á. L'encodage source étant conservé, vérifiez que votre fichier est déjà dans l'encodage attendu par le projet, en général UTF-8.
• Noms à garder : si votre produit s'appelle « Dashboard », vérifiez sur l'extrait gratuit, puis dans la traduction, qu'il n'est pas devenu « Painel ». Marquez comme non traduisibles les valeurs techniques glissées dans des chaînes.
• Ponctuation : une source française met une espace avant « : » ou « ? », alors que le portugais n'en met pas. Après toute retouche manuelle, vérifiez aussi qu'un guillemet double ajouté dans une valeur entre guillemets doubles est bien échappé, sinon le fichier ne se charge plus.
• Mois et jours : si votre fichier Rails contient month_names ou day_names, les noms s'écrivent en minuscules en portugais (« janeiro », « segunda-feira »).
• Validation : passez le fichier dans un analyseur YAML et lancez les contrôles de clés manquantes de votre framework avant de l'intégrer.
• Relecture en contexte : affichez les écrans principaux en pt-BR ou en pt-PT. Regardez les boutons longs, les compteurs à zéro et les phrases où une variable impose un accord.

En pratique

1. Choisissez le portugais du Brésil, le portugais européen, ou les deux.
2. Déposez le fichier YAML : le devis s'affiche, calculé sur les mots des valeurs.
3. Lisez l'extrait gratuit : vocabulaire, forme d'adresse, noms de produit.
4. Payez, puis récupérez le fichier traduit et le rapport dans votre espace client.
5. Validez le YAML, remettez-le dans le projet et relisez les écrans.