Utilisation du traducteur pour gérer les dictionnaires

AEM fournit une console pour gérer les traductions des textes utilisés dans l’interface utilisateur du composant. Cette console est disponible à l’adresse

https://<hostname>:<port-number>/libs/cq/i18n/translator.html

Utilisez l’outil Traducteur pour gérer les chaînes de caractères anglaises, ainsi que leurs traductions. Les dictionnaires sont créés dans le référentiel, par exemple /apps/myproject/i18n.

Notez que l’outil Traducteur et les dictionnaires que vous gérez servent à présenter l’interface utilisateur du composant dans différentes langues. Si vous souhaitez traduire une page ou du contenu généré par l’utilisateur, reportez-vous aux sections Traduction de contenu pour des sites multilingues et Traduction de contenu généré par l’utilisateur.

Le traducteur répertorie les textes utilisés dans AEM avec les diverses traductions correspondantes :

Vous pouvez rechercher, filtrer et modifier des textes anglais et traduits. Vous pouvez également exporter des dictionnaires au format XLIFF en vue de la traduction, puis réimporter les traductions dans les dictionnaires.

Il est également possible d’ajouter les dictionnaires i18n à un projet de traduction à partir de cette console. Vous pouvez soit en créer un nouveau ou l’ajouter à un projet existant.

1. Cliquez sur Traduire le dictionnaire.

   

2. Sélectionnez l’option Créer ou Ajouter suivant vos besoins. Une boîte de dialogue s’ouvre.

   

3. Renseignez les champs suivant les besoins et cliquez ensuite sur OK.

4. Vous pouvez à présent cliquer sur OK ou consulter le dictionnaire cible.

   REMARQUE

   Pour plus d’informations sur les projets de traduction, voir Gestion des projets de traduction.

Création d’un dictionnaire

Créez un dictionnaire pour gérer vos chaînes d’IU localisées. Après avoir créé un dictionnaire, vous pouvez utiliser l’outil de traduction pour le gérer.

1. À l’aide de CRXDE Lite, ajoutez le nœud racine (sling:Folder) de votre nouveau dictionnaire comme structure de stockage des définitions de langue :

   /apps/<projectName>/i18n

   Par exemple, /apps/myProject/i18n

2. Ajoutez la structure de langues requise sous ce nœud : Par exemple :

   /apps/myProject/i18n [sling:Folder]
       - de.json [nt:file] [mix:language]
           + jcr:language = de
       - fr.json [nt:file] [mix:language]
           + jcr:language = fr
   

   REMARQUE

   Il s’agit de la structure du module Sling i18n.

3. Rechargez le traducteur et le chemin du dictionnaire (par exemple, /apps/myProject/i18n) sera disponible dans le sélecteur déroulant de la barre d’outils. Sélectionnez-le pour commencer à ajouter des chaînes et leurs traductions.

   REMARQUE

   Le traducteur enregistre uniquement les traductions pour les langues qui sont effectivement présentes sous le chemin (par exemple, /apps/myProject/i18n).

   Vérifiez que ces langues correspondent à celles affichées dans la grille.

Gestion des chaînes de dictionnaire

Utilisez l’outil de traduction pour gérer les chaînes de caractères de vos dictionnaires. Vous pouvez ajouter, modifier et supprimer des chaînes en anglais, mais aussi fournir des chaînes traduites.

Ajout, modification et suppression de chaînes

Ajoutez des chaînes anglaises à un dictionnaire que votre composant a internationalisées. Ajoutez uniquement des chaînes qui sont internationalisées afin de ne pas gaspiller des ressources en traduisant des chaînes qui ne sont pas utilisées.

Les chaînes que vous ajoutez à un dictionnaire doivent correspondre exactement à celle qui est spécifiée dans le code. Si la chaîne anglaise par défaut qui est utilisée dans le code ne correspond pas à la chaîne anglaise figurant dans un dictionnaire, la chaîne traduite n’apparaît pas dans l’interface utilisateur lorsque cela s’avère nécessaire. Les chaînes sont sensibles à la casse.

Fournir des indications pour la traduction

Utilisez la propriété Comment de la chaîne du dictionnaire pour fournir au traducteur des informations sur la signification de la chaîne. En règle générale, l’IU aide les utilisateurs à déterminer la signification des mots ambigus. Cependant, le traducteur ne voit pas la chaîne dans le contexte de l’interface utilisateur. L’indice de traduction permet de lever toute ambiguïté. Par exemple, un commentaire permet au traducteur de comprendre que le mot anglais Request est utilisé comme nom plutôt que comme verbe.

Les indices de traduction permettent également de différencier les chaînes qui sont identiques, mais qui ont des significations différentes. Par exemple, le terme « Search » peut être un substantif ou un verbe ; deux entrées « Search » sont donc requises dans le dictionnaire avec deux indices de traduction différents. Le code qui demande la chaîne contient également l’indice de traduction, de sorte que la chaîne correcte soit utilisée dans l’interface utilisateur.

Insertion de variables indexées

Insérez des variables dans la chaîne localisée pour renforcer la signification contextuelle dans une phrase. Par exemple, après vous être connecté à une application web, la page d’accueil affiche le message « Bienvenue à l’administrateur. Vous avez 2 messages dans votre boîte de réception. » Le contexte de page détermine le nom d’utilisateur et le nombre de messages.

Pour inclure des variables dans la chaîne localisée, placez les index entre crochets à l’emplacement des variables dans le premier argument de la méthode get. Utilisez l’indice de localisation pour décrire les valeurs. Le traducteur doit comprendre la signification des variables, car les structures de phrase varient en fonction de la langue.

Notez que le code qui demande la chaîne traduite fournit des valeurs pour les variables indexées en fonction du contexte.

Par exemple, la chaîne suivante s’affiche lorsqu’un utilisateur se connecte à un site web et est inclus dans le dictionnaire :

Welcome back {0}. You have {1} messages.

Le commentaire suivant décrit les variables :

{0} = the user name, {1} = the number of items in the user's inbox

Modification de chaînes

Vous pouvez modifier ou supprimer des chaînes anglaises à mesure qu’elles sont modifiées ou supprimées dans le code. Lorsque vous modifiez une chaîne, la chaîne d’origine est conservée et une nouvelle chaîne est créée pour tenir compte de la modification. Avant de supprimer une chaîne, assurez-vous qu’aucun code ne l’utilise.

Procédez comme suit pour ajouter une chaîne.

1. Dans le menu déroulant Dictionnaires, sélectionnez le dictionnaire auquel vous ajoutez une chaîne. Dans le menu déroulant, les dictionnaires sont représentés par leur chemin d’accès dans le référentiel.

2. Au-dessus du tableau Chaînes et traductions, cliquez sur Ajouter.

   

3. Dans la zone Chaîne de la boîte de dialogue Ajouter une chaîne, saisissez la chaîne anglaise. Dans la zone Commentaire, saisissez un indice de traduction à l’intention du traducteur, si nécessaire.

4. Cliquez sur OK.

5. Cliquez sur Enregistrer.

   

Procédez comme suit pour modifier une chaîne dans un dictionnaire.

1. Dans le menu déroulant Dictionnaires, sélectionnez le dictionnaire qui contient la chaîne à modifier.

2. Double-cliquez sur la chaîne à modifier.

3. Dans la boîte de dialogue Modifier la chaîne, sélectionnez Modifier la chaîne ou le commentaire (Crée une copie).

   

4. Modifiez la chaîne ou le commentaire, puis cliquez sur OK.

5. Cliquez sur Enregistrer.

   

Procédez comme suit pour supprimer une chaîne d’un dictionnaire.

1. Dans le menu déroulant Dictionnaires, sélectionnez le dictionnaire duquel vous souhaitez supprimer une chaîne.

2. Cliquez sur Supprimer.

   

3. Cliquez sur Enregistrer.

   

Recherche de chaînes

La barre de recherche située au bas de l’outil Traducteur fournit des options de sélection de chaînes :

• Filtrer par texte : modèle à associer à la chaîne, au commentaire ou aux traductions en anglais. Seuls les éléments qui correspondent à l’ensemble ou à une partie du schéma s’affichent dans le tableau.

• Modifications : Any, Modified, New, Deleted : affiche les éléments qui ont été modifiés et non enregistrés.

  • N’importe lequel : affiche les éléments qui ont été modifiés, ajoutés ou supprimés.
  • Modifié : affiche les éléments qui ont été modifiés.
  • Nouveau : affiche les éléments qui ont été ajoutés.
  • Supprimé : affiche les éléments qui doivent être supprimés.
  • Sélections multiples : affiche les éléments qui possèdent toutes les propriétés sélectionnées.

• Avec commentaire : affiche les éléments qui comportent des commentaires à l’intention des traducteurs.

• Traductions manquantes : affiche les éléments pour lesquels il n’existe pas de traduction pour au moins une langue.

1. Sélectionnez les options de filtrage dans la barre de recherche.
2. Pour effectuer un filtrage à l’aide des options, cliquez sur Filtrer.
3. Pour supprimer les filtres et afficher tous les éléments du dictionnaire, cliquez sur Effacer.

Modification des chaînes traduites

Une fois que vous avez ajouté la chaîne anglaise à un dictionnaire, vous pouvez ajouter les traductions de cette chaîne. Vous pouvez également exporter le dictionnaire pour qu’il soit traduit par un tiers.

1. Sélectionnez le dictionnaire propre à votre projet, car il spécifie le chemin d’accès dans le référentiel qui contient les traductions. Sélectionnez, par exemple, Dictionaries (Dictionnaires) en tant que :

   /apps/myProject/i18n

   ATTENTION

   Modifiez uniquement les dictionnaires créés pour votre projet et qui se trouvent sous /apps.

   Les dictionnaires système AEM sont également disponibles dans cet outil. Ne modifiez pas les dictionnaires système AEM, car cela risque de poser des problèmes avec l’interface utilisateur AEM. De plus, vous risquez de perdre les modifications au cours d’une mise à niveau. AEM dictionnaires système se trouvent sous /libs.

2. Pour modifier les textes traduits pour l’une des chaînes, vous pouvez effectuer l’une des opérations suivantes :

   • Double-cliquez sur la langue adéquate de la chaîne requise pour modifier ce texte :

   

   • Double-cliquez sur le champ String (Chaîne) ou Comment (Commentaire) de la chaîne requise pour ouvrir la boîte de dialogue Edit string (Modifier la chaîne). Modifiez les traductions, puis cliquez sur OK pour fermer la boîte de dialogue :

   

3. Cliquez sur Save (Enregistrer) pour valider vos modifications.

   REMARQUE

   Si vous cliquez sur Reset & Refresh (Réinitialiser et actualiser) (au lieu de Save), les textes précédents sont rétablis.

Utilisation de service de traduction tiers

Pour prendre en charge l’utilisation de services de traduction tiers, l’outil de traduction vous permet d’exporter et d’importer des dictionnaires.

Exportation d’un dictionnaire

Exportez un dictionnaire sous la forme d’un fichier XLIFF afin qu’un service tiers puisse traduire les chaînes qu’il contient.

• Exportez un dictionnaire anglais, et insérez les termes anglais et les traductions correspondantes.
• Exportez une partie ou l’ensemble des chaînes anglaises.

Lorsque vous exportez un fichier XLIFF et insérez une langue, la structure des nœuds du dictionnaire dans le référentiel doit inclure cette langue. Si la langue n’est pas incluse, des erreurs se produisent. Par exemple, pour exporter le fichier XLIFF français, le dossier de dictionnaire doit inclure le nœud enfant mix:language nommé fr (Voir Création d’un dictionnaire.)

Procédez comme suit pour exporter un fichier XLIFF pour une langue donnée.

1. Ouvrez l’outil de traduction http://<host>:<port>/libs/cq/i18n/translator.html

2. Dans le menu déroulant Dictionnaires, sélectionnez le dictionnaire à exporter.

3. Cliquez sur Exporter > Exporter les options Xliff XX complètes, où XX correspond au code de langue en deux lettres, tel que DE ou FR.

   Le fichier XLIFF s’ouvre dans un nouvel onglet ou une nouvelle fenêtre.

4. Utilisez les commandes du navigateur web pour enregistrer la page en tant que fichier sur votre système de fichiers ; Fichier > Enregistrer sous, par exemple.

Procédez comme suit pour exporter une partie ou l’ensemble des chaînes anglaises.

1. Ouvrez l’outil de traduction. http://<host>:<port>/libs/cq/i18n/translator.html
2. Dans le menu déroulant Dictionnaires, sélectionnez le dictionnaire à exporter.
3. Si vous exportez un sous-ensemble des chaînes, sélectionnez les éléments du dictionnaire à exporter. Si vous ne sélectionnez aucun élément, tous sont exportés.
4. Cliquez sur Exporter > Exporter la sélection au format Xliff (chaînes uniquement).
5. Dans la boîte de dialogue qui s’affiche, copiez le texte et collez-le dans un fichier texte.

Importation d’un dictionnaire

Importez un fichier XLIFF dans un dictionnaire pour remplir ce dernier. Si le dictionnaire contient une traduction pour une chaîne anglaise et que le fichier XLIFF contient une traduction différente pour la même chaîne, la traduction du dictionnaire est remplacée.

1. Ouvrez l’outil de traduction http://<host>:<port>/libs/cq/i18n/translator.html
2. Cliquez sur Importer > Traductions XLIFF.
3. Sélectionnez le fichier à importer, puis cliquez sur OK.

Gestion des langues prises en charge

Ajoutez ou supprimez des langues prises en charge par l’outil de traduction et fournies aux utilisateurs de vos pages web.

Modification des langues répertoriées dans le tableau de dictionnaire

L’outil Traducteur comprend les langues suivantes dans le tableau du dictionnaire :

• de - Allemand
• fr - Français
• it - Italien
• es - Espagnol
• ja - Japonais
• pt-br - Portugais (Brésil)
• zh-cn - Chinois simplifié
• zh-tw - Chinois traditionnel (prise en charge limitée)
• ko-kr - Coréen

Procédez comme suit pour ajouter ou supprimer des langues.

1. À l’aide de CRXDE Lite, créez un nœud :

   /etc/languages

2. Sur ce nœud, créez une propriété :

   • Nom : languages

   • Type : Multi-String

   • Value : liste des langues à afficher. Par exemple :

     • fr
     • es
   REMARQUE

   Les codes de langue doivent être en minuscules.

3. Cliquez sur Save All (Enregistrer tout) dans CRXDE Lite, puis rechargez le traducteur. La grille est mise à jour pour afficher les langues définies.

   REMARQUE

   Le traducteur enregistre uniquement les traductions pour les langues présentes dans le dictionnaire (c’est-à-dire sous le chemin du dictionnaire tel que /apps/myProject/i18n).

   Vérifiez que ces langues correspondent à celles affichées dans la grille.

Mise à disposition des langues pour les auteurs

Après avoir défini un dictionnaire pour une langue nouvelle de votre instance AEM, vous devez la rendre disponible pour sélection par les auteurs (par exemple, pour l’utilisation dans Préférences) :

1. Pour modifier la liste des langues disponibles dans l’option Preferences (Préférences) de la console Security (Sécurité) :

   1. Créez une superposition dans le code de votre application pour :

              /libs/cq/security/widgets/source/widgets/security/Preferences.js
       and update as required.
      

2. Pour que la langue soit disponible dans Preferences (Préférences) de la console Websites (Sites web), vous devez apporter les modifications suivantes à votre application :

   1. Créez une superposition pour la structure sous :

      /libs/cq/security/content/tools/userProperties

   2. Dans la superposition, mettez à jour la liste des langues sous :

      items/common/items /lang/options

3. Enregistrez toutes les modifications et rechargez la console adéquate.

Modification des noms de langue et des pays par défaut

Plusieurs pays peuvent utiliser une même langue. Par exemple, les États-Unis, le Royaume-Uni et l’Australie utilisent l’anglais. Cela est indiqué par un code indiquant la langue et le pays tels que en_US, en_GB et en_AU.

Les pays par défaut sont utilisés lors de l’affichage de drapeaux (dans la boîte de dialogue de copie des langues, par exemple). Ils sont utilisés pour résoudre le pays pour un code de langue.

Pour modifier les définitions par défaut, procédez comme suit :

1. Une liste des langues est stockée sous :

   /libs/wcm/core/resources/languages

   Superposez-la en la copiant dans :

   /apps/wcm/core/resources/languages

   Modifiez ou étendez ensuite la liste. La propriété defaultCountry sur un noeud de langue (par exemple, ja) doit contenir le code complet, tel que ja_jp, qui définirait jp comme pays par défaut pour la langue ja.

2. Mettez à jour CQ WCM Language Manager.

   • Language list (Liste des langues) :

     chemin d’accès à la liste des langues dans le référentiel. Définissez-le sur l’emplacement utilisé pour le recouvrement :

            /apps/wcm/core/resources/languages
     

   Vous pouvez effectuer cette opération à l’aide de la console web OSGi :

   https://<hostname>:<port-number>/system/console/configMgr/com.day.cq.wcm.core.impl.LanguageManagerImpl 
   

Publication de dictionnaires

Incorporez vos dictionnaires dans le processus de gestion des versions de vos applications AEM. Vous pouvez, par exemple, inclure le dictionnaire dans le module de contenu de votre application en vue d’un déploiement sur l’instance de publication. Cette stratégie offre les avantages suivants :

• Les dictionnaires sont disponibles pour les composants dans leur environnement de publication.
• Les modifications apportées aux chaînes d’IU du composant sont déployées avec les traductions mises à jour.

De même, le test des chaînes du dictionnaire doit être effectué dans le cadre du cycle de développement habituel du logiciel.