Traduire une application Angular en allemand

Ce que contient messages.xlf et ce qui doit en sortir

Avec l'internationalisation intégrée d'Angular, les textes marqués par l'attribut i18n dans les gabarits et par $localize dans le code TypeScript sont extraits par ng extract-i18n dans un fichier messages.xlf. Ce fichier est au format XLIFF 1.2 par défaut, ou XLIFF 2.0 sur option. C'est lui, et lui seul, qu'il faut traduire : chaque unité contient une <source> dans la langue d'origine et attend une <target> en allemand.

La difficulté tient aux balises insérées dans les phrases. Un gabarit comme Vous avez reçu {{ nb }} <b>messages</b> devient, en XLIFF 1.2, une source parsemée d'éléments <x id="INTERPOLATION"/> et <x id="START_BOLD_TEXT"/>. En allemand, ces balises changent souvent de place, car le participe part en fin de phrase : « Sie haben {{ nb }} <b>Nachrichten</b> erhalten ». Si une balise est perdue ou mal fermée, la compilation de la version allemande échoue.

Les identifiants d'unité ne doivent pas bouger, qu'ils soient générés par Angular ou fixés avec @@ (par exemple i18n="@@boutonEnregistrer"). C'est par eux que le compilateur relie la traduction au gabarit.

L'allemand dans une interface Angular : longueur, majuscules, pluriels

• Longueur. Le texte allemand est souvent 20 à 35 % plus long que l'anglais, et les mots composés ne se coupent pas d'eux-mêmes. « Droits d'accès » devient « Zugriffsberechtigungen », et « Paramètres du compte » devient « Kontoeinstellungen ». Un onglet, un bouton ou une colonne calibrés pour le français peuvent alors déborder.
• Majuscules. Tous les noms prennent une majuscule, y compris dans un bouton : « Ajouter au panier » devient « In den Warenkorb ». Une règle CSS text-transform: lowercase ou capitalize héritée de la version française fausse le résultat.
• Registre. On emploie Sie dans un logiciel professionnel, et souvent du dans une application grand public. Un mélange dans la même interface (« Melden Sie sich an » ici, « Speichere deine Daten » là) se remarque aussitôt.
• Ponctuation. L'allemand ne met pas d'espace avant « ? », « ! » ou « : », et ses guillemets s'écrivent „…“. « Mot de passe oublié ? » donne donc « Passwort vergessen? », sans l'espace insécable.
• Pluriels ICU. L'allemand n'a que deux catégories CLDR, one et other. Ainsi, {count, plural, =0 {Aucun fichier} =1 {Un fichier} other {{{count}} fichiers}} devient =0 {Keine Datei} =1 {Eine Datei} other {{{count}} Dateien}. Les mots-clés restent tels quels, seul le texte entre accolades change. Attention au zéro : en français, 0 relève de one ; en allemand, il relève de other (« 0 Dateien »). Une source qui compte sur one pour le zéro doit être revue.

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

Vous déposez le messages.xlf, ou sa copie messages.de.xlf, en XLIFF 1.2 ou 2.0. Manuce remplit les cibles en allemand et conserve les balises d'interpolation. Le fichier rendu est le même : indentation, ordre des unités, guillemets, commentaires, fins de ligne, encodage et BOM restent identiques. Seules les valeurs changent, ce qui garde un diff lisible dans votre dépôt.

Chaque valeur traduite est comparée à la source : les variables et les balises doivent être les mêmes. Si un écart persiste, par exemple un <x id="INTERPOLATION_1"/> manquant, la valeur source est gardée et le rapport le signale.

Certains éléments ne sont pas traduits : les identifiants, les valeurs vides, les URL, les adresses email, les nombres, les couleurs, les formats de date et tout ce qui est marqué non traduisible. Le devis porte sur les mots des valeurs, balises et identifiants exclus.

Vous recevez le fichier XLIFF prêt à remettre dans le projet, souvent dans src/locale/. Il est accompagné d'un rapport qui liste les chaînes traduites, celles laissées telles quelles et la raison.

En revanche, Manuce ne modifie ni vos gabarits ni votre angular.json, ne compile pas l'application et ne contrôle pas l'affichage. Un texte écrit en dur dans un composant, sans i18n ni $localize, n'est pas dans le fichier : il ne sera donc pas traduit. Pour des conditions générales (AGB) destinées à une clientèle allemande, prévoyez une relecture juridique. Manuce ne produit pas de traduction assermentée.

Préparer le fichier et vérifier le build allemand

1. Donnez du contexte aux libellés ambigus avec le sens et la description : i18n="bouton|Enregistre le profil@@saveProfile". « Enregistrer » peut se traduire par « Speichern » (sauvegarder) ou par « Registrieren » (s'inscrire), et une chaîne isolée ne permet pas de trancher.
2. Vérifiez l'en-tête du fichier : target-language="de" sur l'élément <file> en XLIFF 1.2, ou trgLang="de" sur la racine en 2.0.
3. Déclarez la locale "de" dans le bloc i18n de angular.json, en la faisant pointer vers le fichier traduit, puis lancez ng build --localize.
4. Parcourez les écrans les plus denses : barres d'onglets, en-têtes de tableau, boutons à largeur fixe. Avec lang="de" sur la page, la règle CSS hyphens: auto laisse le navigateur couper les mots composés.
5. Contrôlez les pipes. Avec la locale de, DatePipe affiche 15.03.2025 et CurrencyPipe affiche 1.234,56 €. Ces formats viennent des données de locale d'Angular, pas de la traduction : une date écrite en dur dans une chaîne restera telle quelle.
6. Lisez le rapport : chaque chaîne restée dans la langue source y figure, avec sa raison.

En pratique

1. Lancez ng extract-i18n, puis copiez messages.xlf sous le nom messages.de.xlf.
2. Déposez le fichier sur Manuce : le devis s'affiche aussitôt, et vous pouvez obtenir un paragraphe traduit gratuitement pour juger du résultat.
3. Récupérez le fichier XLIFF rempli en allemand et le rapport des chaînes.
4. Placez le fichier dans le projet, déclarez la locale de dans angular.json, puis lancez ng build --localize.
5. Vérifiez les écrans denses, les pluriels et les chaînes signalées par le rapport.