Internationalisation de composants internationalizing-components
Internationalisez vos composants et boîtes de dialogue afin que leurs chaînes d’interface utilisateur puissent être présentées dans différentes langues. Les composants conçus pour l’internationalisation permettent d’externaliser, de traduire et d’importer les chaînes de l’interface utilisateur dans le référentiel. Au moment de l’exécution, les préférences linguistiques de l’utilisateur ou de l’utilisatrice ou les paramètres régionaux de la page déterminent la langue affichée dans l’interface utilisateur.
Procédez comme suit pour internationaliser vos composants et proposer l’interface utilisateur dans différentes langues :
- Mettez en œuvre vos composants à l’aide d’un code qui internationalise les chaînes. Votre code identifie les chaînes à traduire et sélectionne la langue à présenter au moment de l’exécution.
- Créez des dictionnaires et ajoutez les chaînes anglaises à traduire.
- Exportez le dictionnaire au format XLIFF, traduisez les chaînes, puis réimportez les fichiers XLIFF dans AEM.
- Insérez le dictionnaire dans le processus de gestion des versions de votre application.
Dictionnaires de langues language-dictionaries
Le framework d’internationalisation d’AEM utilise des dictionnaires dans le référentiel pour stocker les chaînes en anglais et leurs traductions dans d’autres langues. Le framework utilise l’anglais comme langue par défaut. Les chaînes sont identifiées à l’aide de leur version anglaise. En règle générale, les structures d’internationalisation utilisent des ID alphanumériques pour les chaînes de l’IU. L’utilisation de la version anglaise de la chaîne comme identifiant présente plusieurs avantages :
- Le code est facile à lire.
- La langue par défaut est toujours disponible.
Les modifications de traduction doivent provenir de Git via le pipeline CI/CD dans AEM as a cloud service.
Remplacement de chaînes dans les dictionnaires système overlaying-strings-in-system-dictionaries
Si vos composants utilisent des chaînes qui sont incluses dans les dictionnaires système AEM, dupliquez la chaîne dans votre propre dictionnaire. Tous les composants utiliseront les chaînes de votre dictionnaire.
Notez que vous ne pouvez pas prédire quelle traduction est utilisée lorsque des chaînes sont dupliquées dans les dictionnaires qui se trouvent tous sous le nœud /apps.