Traduire une application Ruby on Rails en allemand

Ce que l'allemand change dans vos fichiers de langue Rails

Un fichier config/locales/fr.yml qui passe à l'allemand rencontre quatre contraintes, visibles dans toute l'interface.

• Longueur. Un texte allemand est souvent 20 à 35 % plus long que l'anglais, et les mots composés allongent surtout les libellés courts : « Gestion des droits » devient Berechtigungsverwaltung, un seul mot qui ne se coupe pas en fin de ligne. Boutons, onglets, en-têtes de colonnes et menus sont les premiers touchés.
• Majuscules. Tous les noms prennent une majuscule, même en milieu de phrase : Ihre Bestellung wurde gespeichert. Un downcase ou un capitalize appliqué dans une vue sur une valeur traduite casse cette règle.
• Registre. En contexte professionnel, on vouvoie avec Sie : Bitte geben Sie Ihr Passwort ein. Si votre public attend le tutoiement (du), décidez-le avant la traduction et tenez ce choix dans tous les fichiers.
• Ponctuation. Pas d'espace avant : ou ? : « Mot de passe oublié ? » devient Passwort vergessen?. Les guillemets allemands s'écrivent „ainsi“.

Pluriels, variables et messages Active Record

Dans Rails, l'allemand utilise les mêmes catégories de pluriel que le français : one et other. L'écart porte sur zéro : en français on écrit « 0 fichier » au singulier, en allemand 0 Dateien au pluriel. Si vous avez ajouté une clé zero rédigée au singulier, relisez-la.

Exemple : one: %{count} fichier et other: %{count} fichiers deviennent one: %{count} Datei et other: %{count} Dateien. Le nom de la variable reste %{count} ; Manuce compare chaque valeur traduite à la source pour s'en assurer.

Les clés activerecord.models et activerecord.attributes sont reprises dans les messages générés au format %{attribute} %{message}. « E-mail doit être rempli(e) » devient E-Mail muss ausgefüllt werden : l'allemand se passe du « (e) », mais l'ordre des mots reste imposé par ce format. Relisez donc quelques messages complets dans l'application, pas seulement les clés isolées.

Méfiez-vous des phrases qui accolent un article à une variable. En allemand, l'article dépend du genre du nom : der Kunde, die Rechnung, das Projekt. Une tournure comme %{model} wurde gelöscht fonctionne pour tous les modèles ; « Le %{model} a été supprimé », traduit mot à mot, non.

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

Vous récupérez le même fichier YAML, prêt à remettre dans le projet :

• la clé racine fr: remplacée par de: ;
• indentation, ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM conservés : seules les valeurs changent ;
• chaque valeur comparée à la source (variables comme %{name}, balises dans les clés _html) ; 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 que vous avez marqué non traduisible.

Le décompte porte sur les mots des valeurs, clés et balises exclues ; l'allemand est au tarif de base (coefficient ×1).

Ce que Manuce ne fait pas :

• les textes écrits en dur dans les vues .erb ou les contrôleurs, absents des YAML, ne sont pas traités ;
• un format comme %d/%m/%Y reste tel quel : à vous d'écrire %d.%m.%Y, l'usage allemand ;
• les noms de mois et les séparateurs de nombres (1.234,56) viennent en général de la gemme rails-i18n, pas de vos fichiers ;
• pas de traduction assermentée : une interface n'en a pas besoin, mais un document contractuel à produire devant une administration allemande, si.

Préparer les fichiers et vérifier après livraison

Avant le dépôt :

• rassemblez tous les YAML de la langue source : un projet Rails répartit souvent ses textes entre fr.yml, models/fr.yml ou devise.fr.yml ;
• supprimez les clés qui ne servent plus, elles seraient comptées et traduites ;
• marquez comme non traduisibles les noms de marque ou de produit qui doivent rester tels quels ;
• vérifiez que le fichier se charge sans erreur dans votre application.

Après livraison :

• enregistrez le fichier sous de.yml (ou devise.de.yml) et ajoutez :de à config.i18n.available_locales ;
• lisez le rapport : une chaîne restée en français à cause d'une variable doit être reprise à la main ;
• parcourez les écrans aux libellés les plus longs, à la largeur la plus étroite, pour repérer les mots composés qui débordent ;
• un outil comme i18n-tasks aide à repérer les clés présentes en fr mais absentes en de.

En pratique

1. Déposez votre fichier config/locales/fr.yml et les autres YAML de langue.
2. Choisissez l'allemand et le niveau, puis lisez l'extrait gratuit.
3. Récupérez le fichier avec sa clé racine de: et le rapport des chaînes.
4. Enregistrez-le sous de.yml, ajoutez :de aux langues disponibles et adaptez les formats de date.
5. Testez les écrans aux libellés les plus longs.