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

Les attributs de métadonnées standards DITA audience, platform, product, et otherprops peuvent être appliqués aux éléments pour permettre le traitement conditionnel des références croisées. Si vous placez les références croisées à la fin d'une phrase, il sera moins difficile d'exclure une référence croisée sans affecter le sens de la phrase.

Si vous avez besoin créer des références croisées vers différentes ressources selon différentes publications, utilisez l'attribut audience pour définir cette condition. Par exemple, si la version PDF du document de sortie contient des liens différents de ceux de la version d'aide, vous pouvez inclure deux éléments xref adjacents, l'un avec l'attribut audience ayant pour valeur pdf_user, et l'autre ayant pour valeur help_user.

Pour DITA 1.2 (et versions ultérieures), privilégiez l'utilisation de l'élément keyref pour dupliquer et conditionnaliser les éléments.

Si vous utilisez une référence croisée conjointement avec un traitement conditionnel, il sera plus facile de l'exclure si vous placez l'élément de référence croisée (xref) dans le texte à la fin de la phrase.

Par exemple, si une référence croisée doit être incluse dans la publication Web d'une collection DITA, mais exclue de la version PDF, l'attribut audience peut donc être utilisé pour différencier le texte uniquement destiné au format PDF.

Le code :
<p>Le réservoir de dilatation du liquide de refroidissement est joint au pare-feu
<ph audience="help_user">, comme illustré dans 
<xref href="c_engine_bay#eng_bay/fig_coolant_system" type="fig"/></ph>.
</p>
doit donner dans le document de sortie Le réservoir de dilatation du liquide de refroidissement est joint au pare-feu. lorsque le contenu de la valeur help_user est exclu, et Le réservoir de dilatation du liquide de refroidissement est joint au pare-feu, comme illustré dans la Figure 3., lorsqu'il est inclus.