Traduire une application Java (Spring) en espagnol

Ce que l’espagnol change dans vos messages Spring

L’espagnol s’écrit en alphabet latin, de gauche à droite, mais il impose quelques contraintes que l’on découvre souvent à l’écran plutôt que dans le fichier.

• Ponctuation inversée. Une question commence par ¿ et une exclamation par ¡. La valeur doit donc contenir la phrase entière : confirm.delete=¿Desea eliminar {0}?. Si votre gabarit Thymeleaf ajoute lui-même le « ? » après le message, le signe d’ouverture manquera ou sera en trop.
• Longueur. Le texte espagnol est d’une longueur proche du français, plus long que l’anglais. Depuis une source française, les boutons bougent peu ; depuis une source anglaise, « Sign in » devient Iniciar sesión et « Save » Guardar : vérifiez les menus et les colonnes étroites.
• Genre. Un message générique comme {0} supprimé devient eliminado ou eliminada selon l’objet. Mieux vaut des clés distinctes (file.deleted, invoice.deleted) qu’une seule chaîne partagée.
• Registre. Choisissez entre tú et usted avant de traduire, et, pour l’Espagne, entre vosotros et ustedes au pluriel : ¿Tenéis cuenta? ne se dit pas au Mexique.
• Vocabulaire. ordenador en Espagne, computadora en Amérique latine ; de même móvil et celular.

Pluriels, dates, nombres et choix de la locale

Une partie de la localisation ne se joue pas dans la traduction mais dans le code Java. Mieux vaut le savoir avant de relire.

• Pluriels. Les catégories CLDR de l’espagnol sont one, many et other. Zéro relève de other (0 archivos), et many couvre les grands nombres ronds qui prennent « de » : 1 millón de usuarios. Le ChoiceFormat de MessageFormat ne connaît pas ces catégories ; une forme comme {0,choice,0#ningún archivo|1#un archivo|1<{0} archivos} suffit dans la plupart des écrans, mais relisez chaque branche.
• Dates et nombres. Ne les figez pas dans les messages : formatez-les avec DateTimeFormatter ou NumberFormat et la Locale de la requête. L’Espagne écrit 1.234,56, le Mexique 1,234.56. Les formats de date présents dans un fichier ne sont pas traduits par Manuce.
• Nom du fichier. messages_es.properties sert tout l’espagnol ; messages_es_ES.properties ou messages_es_MX.properties permettent une variante par pays, avec repli sur messages_es.
• Repli de Spring. Avec Spring Boot, spring.messages.fallback-to-system-locale vaut true par défaut : une clé absente de messages_es peut s’afficher dans la langue du serveur plutôt que dans messages.properties. Pensez-y si un écran espagnol montre du français.

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

Vous recevez le même fichier, dans le même format : indentation, ordre des clés, commentaires, fins de ligne, encodage et BOM conservés. Seules les valeurs changent.

• Échappements. Si votre source écrit les accents en \u00E9, le fichier espagnol garde cette convention : ñ sort en \u00F1 et ¿ en \u00BF. S’il est en UTF-8 direct, il le reste.
• Lignes de continuation. Les valeurs coupées par \ en fin de ligne sont traitées comme une seule chaîne.
• Apostrophes de MessageFormat. Dans un message à arguments, l’apostrophe doit être doublée. Le l''utilisateur d’une source française disparaît en espagnol (el usuario), mais si la traduction en introduit une, elle est gérée.
• Contrôle. Chaque valeur traduite est comparée à la source : variables {0}, {min}, balises <b>. En cas d’écart persistant, la valeur source est gardée et le rapport le signale.
• Non traduits. Clés, valeurs vides, URL, adresses email, nombres, couleurs, formats de date, identifiants et tout ce qui est marqué non traduisible.

Manuce ne modifie ni votre code Java ni vos gabarits, et ne crée pas de lui-même une variante es_MX à côté d’une variante es_ES : pour deux marchés, dupliquez le fichier et ajustez le vocabulaire. Il ne produit pas non plus de traduction assermentée.

Préparer le fichier et vérifier après livraison

Avant l’envoi :

• Partez du fichier de référence le plus complet, en général messages.properties dans src/main/resources. Si vous utilisez Bean Validation, envoyez aussi ValidationMessages.properties : ses {min} et {max} sont contrôlés comme les autres variables.
• Ajoutez des commentaires utiles au-dessus des clés ambiguës : # bouton, 12 caractères max, # objet féminin : factura. Ils sont conservés.
• Indiquez le registre voulu (tú ou usted) et le marché visé.

Après livraison :

1. Lisez le rapport : une valeur restée en source signale souvent une variable mal placée dans l’original.
2. Enregistrez le fichier sous le bon nom et lancez l’application avec l’en-tête Accept-Language: es ou es-ES.
3. Parcourez les écrans où apparaissent ¿, ñ et les accents : un caractère illisible trahit un encodage mal déclaré (spring.messages.encoding).
4. Testez les pluriels avec 0, 1 et un grand nombre.

L’espagnol est facturé au tarif de base (coefficient ×1), sur les mots des valeurs uniquement.

En pratique

1. Récupérez messages.properties (et ValidationMessages.properties si besoin) dans src/main/resources.
2. Commentez les clés ambiguës et notez le registre (tú ou usted) et le pays visé.
3. Déposez le fichier, choisissez le niveau et lisez l’extrait gratuit.
4. Enregistrez le fichier rendu sous messages_es.properties (ou es_ES, es_MX) à côté de l’original.
5. Lisez le rapport puis testez l’application avec Accept-Language: es.