L'élément xref

L'élément de référence croisée est utilisé pour lier ou pour faire le référencement croisé d'un texte au sein d'une rubrique à d'autres rubriques, lier des éléments au sein d'une rubrique, ou lier des ressources externes à une collection DITA.

L'élément xref (référence croisée) vous permet de lier du texte contenu dans le corps d'une rubrique DITA à différentes ressources cibles. Même si vous pouvez renseigner le texte manuellement pour les références croisées ou les liens eux-mêmes, vous devriez plutôt laisser DITA calculer le texte en fonction du type de ressource que vous souhaitez lier. Pour préciser que vous souhaitez que DITA calcule le texte de référence croisée, laissez l'élément vide. Par exemple, si vous créez une référence croisée pour un élément fig (figure), le texte de la référence croisée peut être automatiquement généré ainsi : Figure 15. Si vous insérez du texte au sein de l'élément xref, ce texte sera utilisé comme texte de la référence croisée.

De même, si vous créez une référence croisée vers une rubrique et que vous laissez l'élément xref vide, le titre de la rubrique cible sera utilisé comme texte de la référence croisée. Vous trouverez des exemples de texte de référence croisée générés automatiquement dans la section Exemple de rubrique : les références croisées.