Traduire un fichier YAML en italien

Apostrophes, accents et majuscules : l’italien dans la syntaxe YAML

L’italien élide sans cesse : l’account, dell’utente, un’email, c’è. Dans un fichier YAML, cette apostrophe ne pose aucun problème dans une valeur sans guillemets ou entre guillemets doubles. Entre guillemets simples, en revanche, elle doit être doublée : confirm: 'Eliminare l''account?'. Une apostrophe simple isolée ferme la chaîne et empêche le chargement du fichier.

Manuce conserve le style de guillemets de chaque valeur. Une chaîne source sans apostrophe, écrite entre guillemets simples, peut donc en contenir une ou deux une fois en italien. C’est le premier point à contrôler, et le plus facile : passer le fichier rendu dans un analyseur YAML (ou simplement relancer vos tests) signale immédiatement toute chaîne mal fermée.

Les accents italiens sont surtout graves en fin de mot (è, può, città, lunedì), avec quelques aigus (perché, né). Ils s’écrivent avec le vrai caractère accentué, pas avec l’apostrophe de substitution des claviers sans accents (perche'), ce qui suppose un fichier en UTF-8. L’encodage et le BOM de votre fichier sont conservés tels quels : un fichier source dans un ancien encodage le restera, mieux vaut le convertir avant.

Enfin, l’italien met moins de majuscules que l’anglais : jours et mois en minuscules (gennaio, martedì), une seule capitale initiale dans les titres d’écrans et de boutons (Impostazioni account, et non Impostazioni Account).

Pluriels one, many, other ; genre et registre autour des variables

Le CLDR attribue à l’italien trois catégories de pluriel : one, many et other. La catégorie many concerne certains grands nombres ronds, devant lesquels l’italien intercale « di » : 1 milione di file, alors que 2 file relève de other. Manuce adapte les blocs de pluriel à la langue cible ; vérifiez ensuite quelles catégories votre bibliothèque i18n attend pour l’italien, afin qu’aucune clé ne soit ignorée ni manquante.

Exemple Rails : one: "%{count} file eliminato" et other: "%{count} file eliminati". Le nom file est invariable, mais le participe s’accorde : eliminato, eliminati, et au féminin eliminata, eliminate (2 foto eliminate).

Le genre est le vrai piège des variables. « Bienvenue, %{name} » devient Benvenuto ou Benvenuta selon la personne, ce que la traduction ne peut pas deviner. Une tournure neutre comme Le diamo il benvenuto, %{name} évite la question. De même, l’article italien dépend du mot qui suit : il %{item} devrait parfois être lo, l’ ou la selon la valeur injectée. Une phrase sans article collé à une variable est plus sûre.

Pour le registre, la traduction suit le vouvoiement formel italien, le Lei : Inserisca la password. Beaucoup d’interfaces italiennes tutoient (Inserisci la password) ou emploient l’infinitif (Inserire la password). Manuce ne reçoit pas de consigne de registre : si votre produit tutoie, regardez l’extrait gratuit avant de payer et prévoyez une relecture de ces chaînes.

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

Vous récupérez le même fichier, dans le même format, prêt à remettre dans le projet. Pour Rails, Symfony, Hugo et i18n-js, la clé racine de langue est gérée (par exemple fr: devient it:). Indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM sont conservés ; les ancres (&defaults, *defaults) et les blocs | et > aussi. Seules les valeurs changent.

Ne sont pas traduits : les clés, les valeurs vides, les URL, les adresses email, les nombres, les couleurs, les formats de date (un "%d/%m/%Y" reste tel quel), les identifiants et tout ce qui est marqué non traduisible. Les variables %{name} et {name} sont vérifiées : chaque valeur traduite est comparée à la source (variables, balises) et, en cas d’écart persistant, la valeur source est gardée et le rapport le dit.

Le rapport livré avec le fichier liste les chaînes traduites et celles laissées telles quelles, avec la raison. Le devis porte sur les mots des valeurs, clés et balises exclues.

Ce que Manuce ne fait pas : il ne reçoit ni glossaire ni consigne de terminologie, ne choisit pas entre tu et Lei à votre place, ne devine pas le genre de ce que contiendra une variable et n’exécute pas votre application. L’affichage réel des chaînes reste à contrôler chez vous.

Préparer le fichier et vérifier la version italienne

• Avant l’envoi : convertissez le fichier en UTF-8 s’il ne l’est pas, et marquez comme non traduisibles les noms de produit ou de fonction à garder tels quels, puis contrôlez-les dans l’extrait gratuit et dans la traduction.
• Validité YAML : chargez it.yml dans un analyseur ou lancez vos tests ; cherchez en priorité les valeurs entre guillemets simples contenant l’, dell’, un’.
• Comparaison : un diff entre la source et le fichier italien ne doit montrer que des valeurs modifiées, jamais une clé ni une indentation.
• Pluriels : affichez les chaînes avec count à 1, 2 et un million pour voir one, other et many.
• Genre et articles : relisez toutes les valeurs où une variable suit un article ou précède un adjectif ou un participe.
• Longueur : l’italien est proche du français, mais certains libellés s’allongent (Impostazioni pour « Réglages ») ; vérifiez boutons et onglets étroits.
• Nom du fichier : renommez selon votre outil, par exemple messages.it.yaml pour Symfony ou i18n/it.yaml pour Hugo.

En pratique

1. Convertissez le fichier en UTF-8 si nécessaire et marquez les termes à ne pas traduire.
2. Déposez le fichier YAML et choisissez l’italien : le devis s’affiche aussitôt, calculé sur les mots des valeurs.
3. Lisez l’extrait gratuit pour juger le registre et la terminologie, puis réglez la commande.
4. Récupérez le fichier italien et son rapport, validez-le avec un analyseur YAML et testez les pluriels et les variables dans l’application.