19.3. navref

L'élément <navref> représente un pointeur vers une autre carte qui devrait être conservé comme lien transcluant plutôt que résolu. Les formats de sortie qui gèrent une telle liaison intègreront la cible lors de l'affichage de la carte appelante pour l'utilisateur final

Par exemple, si on convertit une carte au format du système d'aide Eclipse, on devrait convertir l'élément DITA <navref mapref="other.ditamap"/> vers l'élément Eclipse <link toc="other.xml"/>. Lorsqu'Eclipse charge la carte appelante, il remplacera cet élément <link> par le contenu du fichier other.xml, à condition que ce fichier soit disponible.

Notez que les formats de sortie ne gèreront pas tous une telle liaison. Pour inclure des cartes cibles directement sans dépendre du format de sortie, on peut référencer la carte en utilisant un élément <topicref> avec l'attribut format="ditamap". Par exemple, le balisage suivant représente une inclusion littérale de la carte other.ditamap (similaire à un attribut conref) :

<topicref href="other.ditamap" format="ditamap"/>

Exemple

Dans cet exemple, la carte intitulée « MyComponent tasks » référence les cartes othermap2.dita et othermap3.dita.

<map title="MyComponent tasks">
 <navref mapref="../com.ibm.xml.doc/othermap1.ditamap" />
 <navref mapref="../com.ibm.xml.doc/othermap2.ditamap" />
</map>

Contient :

Doctype Modèle de contenu
map, bookmap pas de contenu

Contenu par :

Doctype Parents
bookmap, map map, topicref, topichead, topicgroup

Héritage :

- map/navref