Une table des relations est contenue dans l’élément <reltable>. L’élément <reltable> est toujours un enfant de l’élément <map> ou <bookmap>. Une carte ou bookmap peut contenir plusieurs éléments <reltable>.
L’emplacement de l’élément <reltable> est différent pour les cartes et les bookmaps :
- Dans une carte, les éléments <reltable> peuvent se trouver n’importe où. Cependant, il est généralement placé à la fin de la carte (après le dernier des éléments <topicref>).
- Dans une bookmap, les éléments <reltable> doivent apparaître comme les derniers éléments de la bookmap (c’est-à-dire avant la balise </bookmap>).
Chaque colonne d’une table des relations contient un type d’information similaire. Le type d’information dans chacune des colonnes est défini par les éléments <relcolspec> dans la ligne d’en-tête de la table des relations (<relheader>).
Dans la forme la plus courante de la table des relations, les éléments <relcolspec> définissent des colonnes pour les concepts, les tâches et les références. Toutefois, une table des relations ne se limite pas à ces types.
Pratique
- Ouvrez le fichier exemples_cartes_bookmaps/exemples/_reltable_debut.ditamap.
Cette carte est déjà peuplée d’éléments <topicref>.
- À la fin du fichier, avant la balise </map>, ajoutez un élément <reltable>.
...
</topichead>
</topicref>
<mapref href="g_orggloss_canards.ditamap" format="ditamap"/>
<reltable title="Table des relations canards">
</reltable>
</map>
Veuillez noter que vous pouvez utiliser l’attribut title dans l’élément <reltable> pour vous aider à identifier l’objectif de la table des relations, mais le titre n’est jamais affiché dans le document généré.
- À l’intérieur de la table des relations, ajoutez un élément <relheader> contenant trois éléments <relcolspec>.
<reltable title="Table des relations canards">
<relheader>
<relcolspec/>
<relcolspec/>
<relcolspec/>
</relheader>
</reltable>
- Ajoutez un attribut type à chacun de trois éléments <relcolspec> pour les concepts, tâches et références.
<relheader>
<relcolspec type="concept"/>
<relcolspec type="task"/>
<relcolspec type="reference"/>
</relheader>
Vous continuez à remplir l’élément <reltable> dans la section suivante.
Contributeurs
