Création de mappages à partir de modèles personnalisés id225VF0808MP
Vous pouvez créer des modèles de carte personnalisés et les utiliser pour créer des cartes DITA avec les modèles de rubrique et les modèles de carte référencés dans le modèle de carte
Vous pouvez vous reporter à d’autres modèles de carte et modèles de rubrique à partir du modèle de carte personnalisé. Les modèles de mappage référencés peuvent faire référence à divers modèles de mappage, modèles de rubrique, rubriques, mappages, images, vidéos et autres ressources. Le modèle de mappage personnalisé peut vous aider à répliquer très facilement les modèles de mappage et l’ensemble de la structure de dossiers à laquelle il est fait référence. Ces modèles personnalisés sont particulièrement utiles pour créer et recréer plusieurs mappings dotés de structures et de références récursives.
Création de modèles personnalisés
Adobe Experience Manager Guides vous permet de créer des cartes et des rubriques personnalisées à partir du dossier dita-templates . Vous pouvez utiliser ces modèles personnalisés pour créer votre carte et votre rubrique. Vous pouvez également partager ces modèles avec vos auteurs et les utiliser pour créer leurs fichiers. Grâce à ces modèles, vous pouvez permettre aux auteurs de conserver des copies distinctes de certaines ressources qui se trouvent dans le dossier des modèles.
Vous pouvez créer des modèles de carte et de rubrique des manières suivantes :
Création de modèles personnalisés à partir de l’éditeur
La fonctionnalité Modèles est présente dans le panneau Gauche de l’interface de l’éditeur et n’est disponible que pour les administrateurs et administratrices. Grâce à ce panneau, l’administrateur peut facilement créer et gérer des modèles qui peuvent ensuite être utilisés par les auteurs. Par défaut, les modèles sont classés sous des modèles de type map et topic.
Par défaut, vous pouvez afficher les fichiers par titres. Pointez sur un modèle pour afficher le titre du fichier et le nom du fichier sous forme d’info-bulle.
Pour créer une rubrique ou un modèle de mappage à partir de l’éditeur, procédez comme suit :
-
Ouvrez le panneau Modèles dans l'éditeur et sélectionnez l'icône Créer un modèle DITA.
-
Choisissez Modèle de rubrique ou Modèle de carte dans le menu déroulant en fonction du type de modèle que vous souhaitez créer.
-
Si vous sélectionnez Modèle de rubrique, la boîte de dialogue Nouveau modèle de rubrique s'affiche.
Si vous sélectionnez Modèle de mappage, la boîte de dialogue Nouveau modèle de mappage s’affiche.
Vous pouvez également sélectionner Dossier dans la liste déroulante si vous souhaitez d’abord créer un dossier dans le dossier topic ou map.
-
Dans la boîte de dialogue Nouveau modèle de rubrique/ Nouveau modèle de carte, indiquez le Titre qui s’affiche dans le panneau Modèles. Le Nom du modèle est suggéré automatiquement en fonction du titre, mais vous pouvez fournir un nom de fichier différent.
Choisissez également le type de modèle que vous souhaitez créer dans la liste déroulante Modèle.note note NOTE Si votre administrateur a activé les noms de fichiers automatiques en fonction du paramètre UUID, vous ne verrez pas le champ Nom . -
Sélectionnez Créer.
Une fois le modèle créé, vous devez l’ajouter à votre profil global ou au niveau du dossier. Une fois le modèle ajouté, vos auteurs commencent à afficher le nouveau modèle dans le processus de création de rubrique/carte.
À l’aide du menu Options sur un modèle existant, vous pouvez choisir de le Modifier ou Dupliquer. En cas de duplication, la structure et le type (du document) du modèle sont conservés et vous pouvez les réutiliser pour créer un autre modèle à partir de celui-ci.
Création de modèles personnalisés à partir de l’interface utilisateur d’Assets
Pour créer un mappage ou un modèle de rubrique à partir de l’interface utilisateur d’Assets, procédez comme suit :
-
Dans l’interface utilisateur d’Assets, accédez au dossier dita-templates .
-
Ouvrez le dossier topics pour créer un modèle Topic. Ouvrez le dossier mappages pour créer un modèle Mappage.
-
Sélectionnez Créer > modèle DITA.
-
Sur la page Plan directeur, sélectionnez Rubrique > Suivant pour créer un modèle de rubrique. Sinon, sélectionnez Mapper > Suivant pour créer un modèle de mappage.
-
Sur la page Propriétés , spécifiez le modèle Titre.
-
Spécifiez le fichier Nom.
note note NOTE Le nom de fichier doit avoir l’extension .dita. -
(Facultatif) Ajoutez une description.
-
Sélectionnez Créer.
Le message de création du modèle de rubrique s’affiche. Vous pouvez ensuite ouvrir le modèle et le modifier. Pour un modèle de mappage, vous pouvez également ajouter les références des modèles de rubrique et de mappage, ainsi que d’autres ressources dans le modèle de mappage.
Menu Options de l’interface utilisateur d’Assets
Pour créer un mappage ou un modèle de rubrique à l’aide du menu Options de l’interface utilisateur d’Assets, procédez comme suit :
-
Sélectionnez le dossier Map ou Topic dans le dossier des modèles actifs. Par exemple, le dossier
dita-templates
. -
Dans le menu Options, sélectionnez Créer un modèle de carte ou Créer un modèle de rubrique.
La boîte de dialogue Créer un modèle de carte ou Créer un modèle de rubrique s’ouvre.
-
Saisissez le titre et le nom du nouveau modèle.
-
Sélectionnez le type de modèle à créer dans la liste déroulante Modèle.
Le message de création du modèle de mappage s’affiche. Vous pouvez ajouter le modèle à votre profil global ou au niveau du dossier. Le nouveau modèle apparaît ensuite dans le processus de création de rubrique ou de carte, et vous pouvez créer des cartes ou des rubriques à l’aide de celui-ci.
Votre administrateur peut également créer un dossier et le configurer pour qu’il soit le dossier dans lequel vous pouvez créer et enregistrer les modèles.
En fonction de votre configuration, apprenez à configurer le chemin d'accès au dossier du modèle DITA personnalisé :
Transmission du titre défini dans les modèles
Si vous souhaitez transmettre le titre du sujet ou du plan utilisé dans votre modèle aux plans DITA créés à l'aide de ce modèle, utilisez des crochets autour du titre.
Exemple
<pubtitle>
<mainpubtitle outputclass="booktitle">
{title}
</mainpubtitle>
<subtitle>Subtitle</subtitle>
</pubtitle>
The resultant DITA map with title "Rootmap1" will look like as follows:
<pubtitle>
<mainpubtitle outputclass="booktitle">Rootmap1
</mainpubtitle>
<subtitle>Subtitle</subtitle>
</pubtitle>
Si vous n'utilisez pas d'accolades autour du titre, seul le premier élément sera sélectionné dans le plan DITA résultant et l'imbrication du titre ne sera pas sélectionnée dans le modèle. Il se présentera comme suit :
<pubtitle> Rootmap1 </pubtitle>
Exemple
<title>
<sub>
<b>{title}</b>
</sub>
</title>
Utiliser le modèle de mappage pour créer de nouveaux mappages
Dans l’éditeur, procédez comme suit pour créer un mappage à l’aide du modèle de mappage personnalisé :
-
Dans l’Éditeur, accédez au dossier dans lequel vous souhaitez créer le mappage.
-
Dans le menu Options du dossier, sélectionnez Nouveau > Plan DITA.
-
La boîte de dialogue Nouvelle carte s’affiche.
-
Dans la boîte de dialogue Nouveau mappage, spécifiez le mappage Titre, le fichier Nom et sélectionnez le modèle de mappage à utiliser.
Par exemple, si vous avez créé un modèle de mappage « test-template », sélectionnez-le.
-
Sélectionnez Créer.
Le message Mappage créé s’affiche.
Dans l’interface utilisateur d’Assets, procédez comme suit pour créer un mappage à l’aide du modèle de mappage personnalisé :
-
Dans l’interface utilisateur d’Assets accédez au dossier dans lequel vous souhaitez créer le mappage.
-
Sélectionnez Créer > DITA Map.
-
Sur la page Plan directeur, sélectionnez le modèle de carte à utiliser, puis sélectionnez Suivant. Par exemple, si vous avez créé un modèle de mappage « test-template », sélectionnez-le.
-
Sur la page Propriétés , spécifiez le mappage Titre.
-
Spécifiez le fichier Nom.
note note NOTE Le nom du fichier doit avoir l’extension .ditamap. -
Sélectionnez Créer. Le message Mappage créé s’affiche.
Notes supplémentaires pour les plans DITA créés à l'aide de modèles personnalisés
La carte génère toutes les ressources qui sont référencées à l’intérieur du dossier de modèles. Certains types de ressources référencés dans un mappage peuvent être les suivants :
-
Si la carte contient la référence à un modèle de rubrique, une copie de celui-ci est créée dans le dossier , dans la même hiérarchie que dans le dossier des rubriques dans le dossier des
dita-templates
. -
Si le mappage contient la référence à un modèle de mappage, une copie de celui-ci est créée dans le dossier , dans la même hiérarchie que dans le dossier des mappages dans le dossier
dita-templates
. -
Si la carte contient la référence générique à une rubrique ou à une carte en dehors du dossier
dita-templates/topics
oudita-templates/maps
, la même référence est uniquement faite et aucune copie n'est créée.note note NOTE dita-templates/topics
etdita-templates/maps
sont les chemins d’accès par défaut dans les guides et peuvent être configurés.S’il existe une définition de clé de modèle de rubrique dans le modèle de carte, une nouvelle clé (par conséquent, nouvelle rubrique) est créée et référencée dans la carte.
-
Si un autre mappage ou une autre rubrique est créé au même niveau dans le dossier, les noms des ressources nouvellement créées sont ajoutés avec 0,1,2, etc. Vous pouvez choisir d’ouvrir le mappage pour le modifier ou d’enregistrer le fichier de mappage dans le référentiel.
Rubrique parente : Présentation de l’éditeur de cartes