Types de références croisées

Dans DITA, une référence croisée est utilisée pour lier ou associer une partie du contenu à une autre. L'élément de référence croisée (xref) est le principal mécanisme permettant de créer des références croisées, mais d'autres éléments peuvent également disposer de cette fonction.

Dans DITA, les références croisées sont bien plus que de simples hyperliens ou des références à des numéros de pages ou à des titres de sections. Beaucoup d'éléments DITA peuvent faire l'objet de références croisées (rubriques, paragraphes, sections, étapes, figures, tableaux, etc.), tout comme les ressources externes au contenu DITA (adresses Web, fichiers réseau et adresses électroniques).

Les références croisées sont principalement mises en œuvre par le biais de l'élément xref et de son attribut href. L'attribut id est également essentiel pour les références croisées dans DITA : seuls les éléments ayant un attribut id peuvent faire l'objet de références croisées.

La fonction de référence croisée peut également se trouver dans des endroits inattendus. Par exemple, l'élément lq inclut un attribut href, utilisé pour stocker l'URL de la source de la citation, le cas échéant. L'élément source dans le prologue d'une rubrique et l'élément link dans la section related-links peuvent également avoir un attribut href pour stocker l'URL de la source originale du contenu de la rubrique.

Les références croisées vers différents éléments sont créées lorsque la collection est traitée (publiée) de différentes manières. Par exemple, une référence croisée vers un élément step peut être générée comme numéro d'étape dans le document de sortie.

La syntaxe DITA pour référencer les éléments contenus dans une même rubrique est #[topicid]/[elementid].

Évitez les références croisées vers de simples paragraphes ; préférez des références croisées vers des rubriques complètes.