Prise en charge des variables de langue

AEM Guides fournit la fonctionnalité permettant d’utiliser des variables de langue. Vous pouvez utiliser des variables de langue pour définir des chaînes localisées dans la sortie du PDF ou pour localiser tout texte statique dans les modèles de sortie. Vous pouvez utiliser des styles CSS pour localiser les chaînes provenant d’une page CSS.

Utilisation de variables de langue dans la sortie du PDF

Vous pouvez utiliser des variables de langue pour définir une version localisée des libellés prêts à l’emploi tels que Remarque, Attention et Avertissement ou texte statique dans la sortie du PDF. Le nom de la variable est le même pour toutes les langues, mais il peut avoir des valeurs différentes pour les différentes langues. Vous pouvez mettre à jour la valeur de ces variables dans une ou plusieurs langues, puis la valeur localisée est automatiquement sélectionnée dans la sortie du PDF.

Par exemple, vous pouvez présenter l’étiquette Note de la manière suivante dans la sortie du PDF :

{width="550"}

Exemple de note en anglais, français et allemand.

Types de variables de langue

AEM Guides prend en charge deux types de variables : les variables Application et User .

Variables d’application

AEM Guides fournit un ensemble de variables d’application prédéfinies ou prêtes à l’emploi. Vous pouvez utiliser ces variables prédéfinies pour ajouter des informations sur un document spécifique à AEM Guides. Par exemple, la variable chapter-number, si elle est incluse dans une page, affiche le numéro du chapitre auquel appartient la page. La variable author-label affiche le nom de l’auteur du document.

Variables utilisateur

Vous pouvez également créer de nouvelles variables de langue. Par exemple, vous pouvez créer une variable utilisateur Éditeur pour le libellé de l’éditeur du document.

{width="550"}

Ajoutez et affichez les variables de langue pour une langue sélectionnée.

Ajouter une nouvelle variable de langue

Exportation et importation de variables de langue

Experience Manager Guides prend en charge l’exportation et l’importation des variables de langue présentes dans la langue sélectionnée. Vous pouvez facilement exporter toutes les variables de langue avec les valeurs définies. Cela inclut les variables d’application et d’utilisateur. Utilisez le fichier exporté pour apporter les modifications souhaitées aux valeurs ou les localiser dans d’autres langues.

Vous pouvez également importer le fichier XML, qui contient les variables de langue. Experience Manager Guides importe uniquement les variables de langue déjà définies, y compris les variables d’application et d’utilisateur. Elle n’importe aucune variable qui n’est pas déjà définie.

Exporter des variables de langue

Pour exporter les variables de langue pour une langue, sélectionnez la langue dans la liste déroulante et sélectionnez Exporter {width="25"}.
Il crée un fichier XML au format language_variable_<ln> où <ln> est le code de la langue sélectionnée. Par exemple, language_variable_en.xml pour l’anglais et language_variable_fr.xml pour le français.

NOTE

Si des modifications non enregistrées sont apportées aux variables de langue, vous ne pouvez pas les exporter. Enregistrez les modifications pour afficher l’option activée Export Icône {width="25"}.

Importation de variables de langue

Pour importer les variables de langue :

<?xml version="1.0" encoding="UTF-8"?>
<variables>
<variable id="note-important">Important: </variable>
<variable id="note-caution">Avertir: </variable>
<variable id="image-with-text">Text and image &lt;img src=&quot;/content/dam/assets/images/image_with_text.png&quot; /&gt; </variable>
</variables>

Les variables avec le même ID sont importées une fois le fichier importé. Les valeurs des variables de la langue sélectionnée sont mises à jour avec celles du fichier XML. Un message sur le nombre de variables mises à jour s’affiche.

Options d’une variable de langue

Passez la souris sur la variable pour afficher le menu Options correspondant.

{width="550"}

Utilisez le menu Options ​pour supprimer, prévisualiser ou dupliquer une variable de langue.

Vous pouvez prévisualiser les variables utilisateur et application. Pour afficher l’affichage de la valeur de la variable dans la sortie, sélectionnez Preview dans le menu Options de la variable sélectionnée.
Vous pouvez également choisir de Supprimer ou Dupliquer les variables utilisateur. La suppression d’une variable d’une langue la supprime automatiquement de toutes les langues.

Modification ou restauration des variables d’application

Vous pouvez également modifier les valeurs d’une variable d’application. Par la suite, vous pouvez rétablir la valeur d’origine d’une variable d’application. Rétablir la variable {width="25"} apparaît pour une variable d’application avec une valeur modifiée.

Utiliser des variables de langue dans les modèles de sortie

Vous devez ajouter des variables de langue dans vos documents localisés. Vous pouvez insérer ces variables de langue dans la mise en page qui s’affiche sur différentes pages de vos documents localisés. Par exemple, vous pouvez ajouter la variable de langue pour le author-name qui apparaît dans la zone d’en-tête de la mise en page (ou toute autre partie comme le pied de page ou le corps).

{width="550"}

L'auteur et le nom de la marque localisés dans la sortie du PDF générée pour la langue française.

Pour insérer une variable de langue comme votre copyright-label dans la zone d’en-tête, procédez comme suit :

{width="550"}

Le copyright-label ajouté dans la zone d’en-tête.

Application du style de contenu aux variables de langue

Outre la valeur que vous affectez à une variable de langue, vous pouvez également utiliser des balises d’HTML pour afficher la valeur de la variable dans une mise en forme spécifique. Par exemple, vous pouvez afficher la valeur de publisher-label en gras.

De même, vous pouvez ajouter des variables de langue et mettre en forme d’autres champs répertoriés dans la fonction Insérer des champs des mises en page. Pour plus d'informations sur l'ajout de champs, consultez Ajout de champs et de métadonnées.

Localisation des chaînes à l’aide des styles CSS

En utilisant des styles CSS, vous pouvez également localiser les chaînes utilisées dans le numéro d’autonumérique telles que Chapitre, Section, Figure et Tableau. Ces chaînes provenant de fichiers CSS, vous ne pouvez pas les localiser à l’aide de variables de langue. Pour localiser ces chaînes, vous pouvez créer des styles CSS pour chaque langue dans laquelle vous souhaitez les localiser.
Vous pouvez, par exemple, utiliser le CSS suivant pour afficher le préfixe Chapitre et le format de nombre correspondant dans différentes langues.
Par exemple, vous pouvez utiliser le CSS suivant pour afficher le chapitre en tant que Hoofdstuk en allemand et le numéro du chapitre au format décimal. Tandis que pour le japonais, vous pouvez utiliser le format de numéro japonais pour afficher les numéros de chapitre dans la table des matières.

// for English
h1:before {
  counter-increment: h11;
  content: "Chapter " counter(h11, decimal)".";
}

// for German
:root:lang(de) h1:before {
  content: "Hoofdstuk " counter(h11, decimal)".";
}

// for Japanese
:root:lang(ja) h1:before {
  content: "章 " counter(h11, japanese-formal)".";
}

Les captures d’écran suivantes affichent les chaînes localisées en sortie PDF allemande et japonaise .

{width="550"}

{width="550"}

Mise en forme des préfixes

Les styles CSS vous permettent également de formater les préfixes. Par exemple, vous pouvez mettre en forme le libellé Note de sorte qu’il apparaisse en rouge dans la sortie PDF de différentes langues.

.note .prefix-content
{
color: red;
}