L'attribut de référencement de contenu : conref

La fonctionnalité conref permet d'utiliser du contenu DITA à plusieurs emplacements au sein d'une même collection. L'attribut conref d'une rubrique cible indique la rubrique source et la portion de cette rubrique à réutiliser.

Dans DITA, le contenu peut être réutilisé au niveau d'une rubrique (une même rubrique utilisée dans plusieurs cartes DITA), d'un bloc ou d'une phrase. Tout élément DITA, que ce soit un paragraphe, un tableau, un pré-requis de tâche, une commande d'interface utilisateur, un terme, une référence croisée ou tout autre segment balisé, peut être réutilisé ailleurs. Pour réutiliser du contenu au niveau d'un bloc ou d'une phrase, on utilise le mécanisme de référence de contenu, ou conref.

La clé du référencement de contenu, ou transclusion, est de pouvoir identifier un segment de contenu à l'aide d'une structure de nommage simple.

On définit une référence de contenu en saisissant l'emplacement du contenu à réutiliser dans l'attribut conref de l'élément dans lequel il sera inclus ou transclus. La valeur de l'attribut conref affiche la syntaxe suivante :

topicfilename#topicid/elementid

où topicfilename est le nom de fichier de la rubrique où se situe le contenu à transclure, topicid l'attribut id de la rubrique, et elementid l'attribut id de l'élément à réutiliser (cette convention de nommage est également utilisée pour les références croisées ainsi que les autres types de liens).

<p conref="c_intercooler.dita#concept_turbo_intercooler/intercooler_temperature"/>

L'idée d'utiliser des conref est apparue avec le langage SGML.