Les références croisées dans les titres

Évitez d'utiliser des éléments de références croisées dans les titres de rubrique.

L'élément title ne peut pas contenir directement d'éléments xref parce que les titres sont utilisés dans beaucoup de contextes différents, dont certains ne comprennent pas les éléments enfants. Par exemple, l'élément title d'une rubrique DITA peut devenir l'élément title contenu dans la section head d'un fichier de sortie XHTML (composé uniquement de texte brut). De la même façon, l'élément titre d'une rubrique DITA peut servir de base au texte du lien vers sa rubrique parente.

C'est pourquoi le fait d'inclure des éléments enfant dans les titres réduit les possibilités de réutilisation, augmente le risque d'erreur de compilation causée par la mauvaise interprétation du balisage et complique ce qui devrait être un simple élément sémantique.

Cependant, d'un point de vue technique, il est possible d'insérer un élément xref ou d'autres éléments enfants au sein d'un élément title en les imbriquant dans un élément ph (autorisé). L'élément title ne peut donc pas contenir d'éléments xref, mais il peut contenir des éléments ph, pouvant comporter des éléments xref.

Conseil : Réfléchissez bien aux conséquences avant d'utiliser cette méthode alternative.