Traduire une application Laravel en italien

Ce que l’italien change dans une interface Laravel

L’italien s’écrit en alphabet latin, de gauche à droite, avec une longueur de texte proche du français. Si votre fichier source est en français, vos boutons et vos messages de validation garderont à peu près leur gabarit. Les difficultés sont ailleurs.

• Le registre. Une application professionnelle s’adresse en général à l’utilisateur avec le Lei de politesse : « Inserisca la password » plutôt que « Inserisci la password ». Décidez-le avant de traduire et tenez-vous-y : un mélange de tu et de Lei d’un écran à l’autre se remarque immédiatement.
• Les accents. L’italien distingue l’accent grave et l’accent aigu : è (est), mais perché, né. En majuscule, on écrit È et non E', une facilité de clavier qui fait négligé dans un titre.
• L’élision devant une variable. Une chaîne comme « Supprimer l’utilisateur :name ? » se traduit sans peine, mais une variable placée juste après un article pose problème : l’article italien dépend du mot qui suit (il, lo, l’, la). La formulation sûre consiste à placer un nom fixe avant la variable : « Il campo :attribute è obbligatorio ».
• L’accord. L’italien accorde participes et adjectifs en genre. « :name a été supprimé » devient « :name è stato eliminato » ou « è stata eliminata » selon ce que désigne la variable ; si elle peut être un produit ou une facture, reformulez avec un nom neutre (« L’elemento :name è stato eliminato »).

Pluriels : la syntaxe Laravel face aux règles italiennes

Le CLDR définit trois catégories de pluriel pour l’italien : one, many et other. La catégorie many concerne les très grands nombres ronds, qui appellent la préposition di : « un milione di utenti ». Dans une interface courante, vous aurez surtout affaire au singulier et au pluriel ordinaires.

Laravel gère le pluriel avec trans_choice et des formes séparées par une barre verticale. Une valeur italienne bien construite ressemble à ceci :

{0} Nessun messaggio|{1} Un messaggio|[2,*] :count messaggi

Points à surveiller :

• le nombre de segments séparés par | doit rester cohérent avec vos appels trans_choice ;
• les intervalles {0}, {1}, [2,*] ne sont pas du texte à traduire et doivent rester identiques ;
• le cas zéro se dit volontiers avec nessun / nessuna, qui s’accorde avec le nom : « Nessuna notifica ».

Relisez ces chaînes plurielles dans le fichier rendu : ce sont elles qui cassent le plus souvent à l’affichage.

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

Manuce prend en charge les fichiers lang/<langue>.json de Laravel. Vous recevez le même fichier, dans le même format : indentation, ordre des clés, guillemets, fins de ligne, encodage et BOM conservés. Seules les valeurs changent.

• Les clés ne sont pas traduites. Dans un fichier JSON Laravel, la clé est souvent la phrase source elle-même ("Welcome, :name") : elle reste telle quelle, c’est elle que votre code appelle.
• Les paramètres sont vérifiés. Chaque valeur traduite est comparée à la source : si :name, :count ou une balise disparaît ou change, et que l’écart persiste, la valeur source est conservée et le rapport le signale. Gardez aussi les variantes de casse que Laravel distingue (:Name, :NAME) : elles font partie du contrôle à relire.
• Ne sont pas traduits : valeurs vides, URL, adresses email, nombres, couleurs, formats de date, identifiants, et tout ce que vous marquez comme non traduisible.
• Un rapport accompagne le fichier : chaînes traduites, chaînes laissées telles quelles et la raison.

Ce que Manuce ne fait pas : les fichiers en tableaux PHP (lang/fr/validation.php, auth.php, ou ceux de lang/vendor) ne sont pas pris en charge ; il faut les convertir en JSON au préalable. Les textes écrits en dur dans vos vues Blade, hors fichier de langue, ne peuvent évidemment pas être traduits. Manuce ne fournit pas non plus de traduction assermentée, au cas où vos conditions générales en italien devraient l’être.

Le devis porte sur les mots des valeurs seulement, clés et balises exclues ; l’italien est au tarif de base (coefficient ×1).

Préparer le fichier avant de le déposer

1. Choisissez la source. Partez du fichier le plus complet et le plus relu, par exemple lang/fr.json ou lang/en.json. Le fichier rendu garde son nom : renommez-le it.json avant de le placer dans lang/.
2. Convertissez les tableaux PHP. Si vos messages de validation ou d’authentification sont dans lang/fr/*.php, exportez-les en JSON. Attention aux clés imbriquées comme validation.min.string : décidez d’une convention de clés à plat avant la conversion.
3. Videz ce qui ne doit pas bouger. Les noms de marque, de plans d’abonnement ou de modules (« Pro », « Dashboard » si c’est un nom de produit) sont à marquer comme non traduisibles.
4. Notez le registre voulu. Lei ou tu : c’est la première question à trancher pour un public italien.

Demandez l’extrait gratuit avant de payer : un paragraphe du fichier traduit au niveau choisi suffit pour juger du registre et du traitement des paramètres.

Vérifier l’application en italien

• Activez la langue avec App::setLocale('it') ou la clé locale de la configuration, et vérifiez que fallback_locale pointe vers votre langue source : une chaîne absente de it.json s’affichera alors sans erreur.
• Parcourez le rapport : chaque valeur restée en langue source y est listée avec sa raison, souvent un paramètre que la phrase italienne déplaçait mal.
• Contrôlez l’affichage des accents : un è transformé en caractère illisible signale un problème d’encodage dans votre chaîne de déploiement, le fichier rendu gardant l’encodage d’origine.
• Les dates et les nombres ne sont pas traduits : leur forme italienne (25/03/2025, 1.250,50) dépend de votre code et de la locale de Carbon, pas du fichier JSON.

En pratique

1. Convertissez en JSON les fichiers de langue en tableaux PHP, s’il y en a.
2. Déposez lang/fr.json (ou votre fichier source) et choisissez l’italien.
3. Lisez l’extrait gratuit pour valider le registre et les paramètres.
4. Récupérez le fichier traduit et le rapport, renommez-le it.json.
5. Placez-le dans lang/, activez la locale it et relisez les pluriels.