Liens dans la section related-links

Lorsqu'une rubrique nécessite des références croisées vers d'autres rubriques et pour que ces références croisées soient toujours valides dans le contexte de la rubrique, elles doivent être contenues dans une section related-links après le corps de la rubrique. Dans tous les autres cas, les références croisées doivent être définies dans la table des relations de la carte DITA.

Il existe trois méthodes pour inclure des liens dans un contenu DITA :

  • insérer des éléments xref n'importe où dans le corps d'une rubrique,
  • insérer les liens dans une section related-links, en dehors du corps de la rubrique,
  • définir les relations du lien via la table des relations de la carte DITA.

Utiliser la table des relations est la méthode la plus efficace pour la plupart des documents. Cependant, si les références croisées sont toujours appropriées selon la rubrique, indépendamment du contexte dans lequel elles sont utilisées, alors la section related-links peut être une bonne approche.

La section related-links est, d'un point de vue technique, une métadonnée. Elle est incluse dans la rubrique mais en dehors du corps de la section. Elle est composée d'éléments link, qui ont une fonction similaire à celle de l'élément xref.