Éléments de référencement valides

Lorsqu'un attribut conref est utilisé au sein d'une rubrique pour transclure du texte à partir d'une autre rubrique, l'élément cible du conref doit être un élément XML valide sous DITA.

La transclusion de contenu implique la présence de deux éléments : l'élément cible du conref et l'élément référencé. L'élément cible du conref est l'élément qui réutilisera le contenu situé dans l'élément référencé (la source du contenu réutilisable).

Lorsque l'élément à transclure requiert des attributs ou des éléments enfant spécifiques, alors ces derniers doivent également être inclus dans le code de l'élément cible du conref.

Par exemple, un élément step doit contenir au minimum un élément cmd. Le balisage suivant serait par conséquent non-valide sous DITA en raison de l'absence de l'élément cmd :

<step conref="t_starting.dita#t120/sec_code" />

Au lieu de cela, un élément cmd factice doit être inclus dans le balisage pour que celui-ci soit valide, comme ci-dessous :

<step conref="t_starting.dita#t120/sec_code"><cmd /></step>

Lorsqu'un attribut est obligatoire au sein d'un élément transclus, par exemple l'attribut tmtype dans l'élément de marque commerciale (tm), l'élément cible du conref doit inclure l'attribut en question. Une valeur spéciale de l'attribut -dita-use-conref-target peut toutefois être utilisée pour conserver la validité de l'élément et spécifier que les attributs de l'élément source référencé doivent être utilisés lors de la transclusion.

<tm conref="conref_source.dita#names12/var_suparu" 
 tmtype="-dita-use-conref-target" />

Si vous avez recours aux contraintes, fonctionnalité mise en place dans la version DITA 1.2, évitez de transclure des éléments depuis une rubrique sans contrainte vers une rubrique avec contrainte (en règle générale, le référencement d'un élément d'une rubrique source sans contrainte depuis une rubrique avec contrainte ne fonctionne que si le type de contrainte est défini comme faible, et non comme strict).