Valeur de l'attribut -dita-use-conref-target

Un attribut avec la valeur spéciale -dita-use-conref-target peut être défini pour forcer l'utilisation de la valeur de l'attribut de l'élément source du conref dans l'élément cible du conref.

Les attributs de certains éléments DITA sont obligatoires, par exemple l'attribut de type de marque commerciale (tmtype) de l'élément de marque commerciale (tm). Lors du référencement de ce type d'élément, les attributs de l'élément source ne sont pas assignés à l'élément cible du conref. L'inclusion de contenu dans l'élément cible du conref n'est donc pas valide, dans la mesure où celle-ci ne possède pas cet attribut obligatoire.

Par exemple, l'élément de marque commerciale :

<tm id="tm_hyperwrite" tmtype="reg">HyperWrite</tm>

devrait être logiquement référencé par le biais de l'inclusion de contenu (conref) :

<tm conref="#about_company/tm_hyperwrite"/>

Toutefois, comme l'élément cible tm du conref ne possède pas d'attribut tmtype, l'élément n'est pas valide.

Pour contourner le problème d'invalidité, il est également possible d'inclure l'attribut dans l'élément source de la référence, comme suit :

<tm conref="#about_company/tm_hyperwrite" tmtype="reg"/>

Cela implique toutefois la répétition des informations, ce qui va à l'encontre du principe de réutilisation.

Les éléments DITA dotés d'attributs obligatoires ou de valeurs énumérées (c'est-à-dire, un choix fixe de valeurs valides) sont également dotés d'une valeur -dita-use-conref-target. Cette dernière force la valeur de l'attribut de l'élément source du conref (l'élément référencé) à être utilisée dans l'élément cible du conref.

L'inclusion de contenu d'une marque commerciale peut, par conséquent, être codée de la façon suivante :

<tm conref="#about_company/tm_hyperwrite" tmtype="-dita-use-conref-target"/>