Traduire une application Vue en anglais : fichiers vue-i18n

Ce qui change quand une interface Vue passe en anglais

L’anglais raccourcit en général le texte de 10 à 15 % par rapport au français. Pour une interface Vue, c’est plutôt une bonne nouvelle : « Enregistrer les modifications » devient « Save changes », et les boutons dimensionnés pour le français gardent de la marge. Les vrais points d’attention sont ailleurs.

• Britannique ou américain. Décidez-le avant de commander : colour/color, licence/license, cancelled/canceled, organise/organize. Ce choix doit correspondre à la locale déclarée dans votre configuration vue-i18n (en-GB ou en-US).
• Ponctuation. L’espace avant les deux-points disparaît : Total : devient Total:. Les guillemets « » deviennent " " ou ‘ ’.
• Tutoiement et accords. L’anglais n’a qu’un you : si votre projet a deux jeux de clés pour « tu » et « vous », ils produiront des valeurs identiques. Les formes inclusives comme « Connecté(e) » se résolvent simplement en « Signed in ».
• Majuscules. Beaucoup d’interfaces américaines écrivent les boutons en Title Case (« Add To Cart »), les interfaces britanniques préfèrent souvent la casse de phrase (« Add to cart »). Indiquez votre convention.
• Dates. Un indice de saisie comme JJ/MM/AAAA doit devenir DD/MM/YYYY au Royaume-Uni et MM/DD/YYYY aux États-Unis. Les formats de date n’étant pas traduits, vérifiez ces valeurs dans le rapport.

Pluriels vue-i18n : du français à one / other

vue-i18n écrit les pluriels dans une seule valeur, séparés par une barre verticale. Manuce conserve ce découpage : le nombre de segments et leur ordre restent identiques, seul leur texte change.

Exemple à trois formes (zéro, un, plusieurs) :

• Source : Panier vide | {n} article | {n} articles
• Rendu : Your basket is empty | {n} item | {n} items

L’anglais n’a que deux catégories CLDR, one et other, et 0 y est au pluriel (« 0 items »), alors qu’en français 0 est au singulier (« 0 article »). Avec deux segments seulement, la règle par défaut de vue-i18n choisit le premier pour 1 et le second pour tout le reste, y compris 0. En anglais, cela tombe juste ; si vous aviez écrit une règle de pluriel personnalisée pour le français, vérifiez qu’elle ne s’applique pas aussi à la locale anglaise.

Testez toujours vos chaînes plurielles avec 0, 1 et 2 dans l’application avant de publier.

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

Vous récupérez le même fichier JSON, prêt à remettre dans src/locales ou l’emplacement de votre projet :

• indentation, ordre des clés, guillemets, fins de ligne, encodage et BOM conservés ; seules les valeurs changent ;
• interpolations nommées comme {name} et formes plurielles séparées par | conservées ;
• 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 ;
• non traduits : clés comme checkout.button.pay, valeurs vides, URL, adresses email, nombres, couleurs comme #1E88E5, formats de date, identifiants, et tout ce que vous avez marqué non traduisible.

Le rapport liste les chaînes traduites et celles laissées telles quelles, avec la raison. 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 lit pas vos composants .vue. Les textes écrits en dur dans les gabarits ou placés dans des blocs <i18n> ne sont pas traités : extrayez-les d’abord dans vos fichiers JSON. Manuce ne modifie pas non plus votre configuration (createI18n, locale de repli, formats de date).

Préparer le fichier et vérifier au retour

Avant l’envoi :

• Partez du fichier source complet, par exemple fr.json, et non d’un en.json à moitié rempli.
• Marquez comme non traduisibles les noms de produit, de module ou de forfait qui doivent rester en français.
• Évitez les phrases découpées en plusieurs clés (Vous avez + {n} + messages) : l’ordre des mots anglais diffère. Une valeur entière avec interpolation, Vous avez {n} messages, se traduit proprement.
• Surveillez les caractères spéciaux du format de message vue-i18n : @, |, {, }. Une adresse comme support@exemple.fr écrite en clair dans une valeur peut être interprétée comme un message lié ; échappez-la dans la source, la traduction gardera cet échappement.

Au retour :

• lisez le rapport, en particulier les valeurs restées en français ;
• lancez l’application en locale anglaise et surveillez les avertissements de clés manquantes dans la console ;
• contrôlez les messages liés du type @:common.save et les valeurs contenant du HTML affichées avec v-html ;
• testez les pluriels avec 0, 1 et 2.

En pratique

1. Rassemblez le fichier de langue source de votre application Vue (par exemple fr.json) et précisez anglais britannique ou américain.
2. Déposez-le sur Manuce : le devis s’affiche aussitôt, et un extrait gratuit vous montre le niveau choisi.
3. Récupérez en.json et le rapport des chaînes traduites ou laissées telles quelles.
4. Placez le fichier dans votre projet, déclarez la locale en-GB ou en-US et testez l’interface, pluriels compris.