Tutoriel : mise en relation indirecte

Utiliser une table externe pour identifier les fichiers liés (<keyref>).

Durée : 20 mn 

Reprise exercice avec gestion externe de lien

Procédure :
  1. Créer la table des mises en relations.
    1. Créer une nouvelle map dans l'éditeur de map qui va accueillir la gestion externe des relations.
    2. Dans cette map, insérez un élément keydef (définition de clé).
      Une fenêtre s'ouvre.
    3. donner la valeur"glossaire_appareil" à keys : c'est la clé par laquelle on va appeler la mise en relation.
    4. Pour l'attribut href, pointez sur le topic g_appareil.dita.
  2. Utiliser la table de clés
    1. Rouvrir la map créée précédemment dans le tutoriel "maps" (tutoriel_map.ditamap).
    2. insérez une référence à la nouvelle map ici créée
    3. enregistrez.
  3. Utilisez la table des mises en relations
    1. Au-dessus de l'éditeur de map, sélectionnez tutoriel_map.ditamap comme "root map".
      Tout le système de gestion des relations va maintenant utiliser tutoriel_map.ditamap comme base de travail.
    2. Rouvrir la recette "couscous vert".
    3. En mode textuel, supprimez l'attribut href de l'élément xref créé dans le tutoriel précédent.
    4. Tapez à la place keyref="".
    5. Placez le curseur entre les deux quotes et tapez simultanément sur les touches "Ctrl"+espace.
    6. Dans la liste, sélectionnez "glossaire_appareil" précédemment créé.
  4. Publiez en HTML et constatez.
  5. Renommez g_appareil.dita en gloss_appareil.dita.
  6. Publiez et constatez.
  7. Modifiez la map de clés pour prendre en compte la modification.
  8. Publiez et constatez.
Résultat :
  • Quel est l'intérêt d'une map de clé externe versus le fait de déclarer les clés directement dans la map tutoriel_map.ditamap ?