Relations entre hiérarchie et liens de la table des relations

Les liens peuvent être générés dans le format de sortie durant la publication grâce à la hiérarchie et aux relations avec la table des relations dans la carte DITA. Peu importe la source, les liens sont incorporés pendant la publication.

Les liens de référence croisée sont automatiquement générés par les outils de publication DITA à partir des relations hiérarchiques dans la carte DITA et de l'association de la table des relations dans la section reltable de la carte DITA. De plus, les liens peuvent être spécifiés dans une rubrique individuelle dans la section related-links (liens associés) de la rubrique.

Peu importe la méthodologie de création de liens utilisée, les liens dans le document de sortie sont incorporés dans des catégories de blocs de liens situés à la fin de la rubrique.

L'illustration Comment sont incorporés les liens apparentés, la hiérarchie et la table des relations dans la rubrique de sortie présente un exemple de liens situés en bas d'une rubrique dans le document de sortie Microsoft HTML Help. Le lien Parent topic: est basé sur la hiérarchie : il est parent de la rubrique actuelle. Les deux premiers liens de la partie Related concepts sont basés sur la hiérarchie de la carte DITA, puisque la valeur de l'attribut collection-type de la rubrique parente est family ce qui signifie que toutes les rubriques sibling doivent être liées entre elles. Le troisième lien est un lien manuel spécifié dans les sections related-links de la rubrique actuelle. Ces trois liens sont tous des types d'information de concept. C'est pourquoi ils ont été regroupés sous le titre Related concepts. Les deux liens de la partie Related tasks sont générés à partir d'une relation dans reltable. Ils sont également regroupés car les deux rubriques sont des types d'information de tâche.

Figure 1: Comment sont incorporés les liens apparentés, la hiérarchie et la table des relations dans la rubrique de sortie

Capture d'écran montrant un ensemble de hiérarchie, table des relations et liens apparentés

Voici les caractéristiques clés de la carte DITA qui permettent de générer le document de sortie dans l'illustration Comment sont incorporés les liens apparentés, la hiérarchie et la table des relations dans la rubrique de sortie : 

...
<topicref collection-type="family" href="c_Engine_Options.dita" type="concept">
   <topicref href="ej20.xml" type="concept"/>
   <topicref href="ej25.xml" type="concept"/>
   <topicref href="ej25_turbo.xml" type="concept"/>
</topicref>
...
<reltable>
   <relrow>
     <relcell>
       <topicref format="dita" href="ej25_turbo.xml" type="concept"/>
     </relcell>
     <relcell>
       <topicref format="dita" href="start_xrw.xml" type="task"/>
      	<topicref format="dita" href="start_lumberer.xml" type="task"/>
     </relcell>
   </relrow> 
</reltable>