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.

NOTE
Les modèles de rubrique ne sont pas créés de manière récursive. Seuls les modèles de rubrique directement à l'intérieur du modèle de carte sont générés et tout modèle de rubrique à l'intérieur d'un modèle de rubrique est simplement référencé directement dans le parent.

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.

NOTE
Toutes les ressources qui ne doivent être référencées et conservées que sur doivent être conservées en dehors du 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.

{width="300"}

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.

NOTE
En tant qu’administrateur, vous pouvez également choisir d’afficher la liste des fichiers dans l’éditeur. Sélectionnez l’option Nom de fichier de la section Configuration de l’affichage des fichiers de l’éditeur dans Préférences utilisateur.

Pour créer une rubrique ou un modèle de mappage à partir de l’éditeur, procédez comme suit :

  1. Ouvrez le panneau Modèles dans l'éditeur et sélectionnez l'icône Créer un modèle DITA.

    {width="500"}

  2. 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.

  3. Si vous sélectionnez Modèle de rubrique, la boîte de dialogue Nouveau modèle de rubrique s'affiche.

    {width="300"}

    Si vous sélectionnez Modèle de mappage, la boîte de dialogue Nouveau modèle de mappage s’affiche.

    {width="300"}

    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.

  4. 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 .
  5. 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.

{width="500"}

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 :

  1. Dans l’interface utilisateur d’Assets, accédez au dossier dita-templates .

  2. Ouvrez le dossier topics pour créer un modèle Topic. Ouvrez le dossier mappages pour créer un modèle Mappage.

  3. Sélectionnez Créer > modèle DITA.

    {width="300"}

  4. 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.

  5. Sur la page Propriétés , spécifiez le modèle Titre.

  6. Spécifiez le fichier Nom.

    note note
    NOTE
    Le nom de fichier doit avoir l’extension .dita.
  7. (Facultatif) Ajoutez une description.

  8. 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 :

  1. Sélectionnez le dossier Map ou Topic dans le dossier des modèles actifs. Par exemple, le dossier dita-templates.

  2. 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.

  3. Saisissez le titre et le nom du nouveau modèle.

  4. 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é :

Services cloud
Découvrez comment configurer le chemin d’accès au dossier du modèle DITA personnalisé dans le Guide d’installation et de configuration des services cloud.
Logiciel On-Premise
Découvrez comment configurer le chemin d'accès au dossier du modèle DITA personnalisé dans le Guide d'installation et de configuration On-premise.

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>
NOTE
Seule la première occurrence de l’accolade sera remplacée par le titre.

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>
NOTE
Vous pouvez également utiliser les accolades autour du texte pour transmettre sa structure imbriquée des modèles personnalisés à vos plans DITA.

Exemple

<title>
    <sub>
        <b>{title}</b>
    </sub>
</title>

Utiliser le modèle de mappage pour créer de nouveaux mappages

NOTE
Le modèle de mappage doit être configuré et mis à disposition pour la création par votre administrateur. Pour plus d’informations, consultez la section Configurer des modèles de création dans la section Installation et configuration d’Adobe Experience Manager Guides as a Cloud Service.

Dans l’éditeur, procédez comme suit pour créer un mappage à l’aide du modèle de mappage personnalisé :

  1. Dans l’Éditeur, accédez au dossier dans lequel vous souhaitez créer le mappage.

  2. Dans le menu Options du dossier, sélectionnez Nouveau > Plan DITA.

    {width="500"}

  3. La boîte de dialogue Nouvelle carte s’affiche.

  4. 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.

  5. 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é :

  1. Dans l’interface utilisateur d’Assets accédez au dossier dans lequel vous souhaitez créer le mappage.

  2. Sélectionnez Créer > DITA Map.

  3. 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.

  4. Sur la page Propriétés , spécifiez le mappage Titre.

  5. Spécifiez le fichier Nom.

    note note
    NOTE
    Le nom du fichier doit avoir l’extension .ditamap.
  6. 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 ou dita-templates/maps, la même référence est uniquement faite et aucune copie n'est créée.

    note note
    NOTE
    dita-templates/topics et dita-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

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178