Insérer des références croisées vers une carte DITA

Évitez d'insérer des références croisées vers les cartes DITA. En effet, DITA ne possède pas de méthode précise permettant cette manipulation et la logique de liaison des métadonnées n'est pas clairement définie.

Créer une référence croisée vers une carte DITA peut sembler banal au premier abord. Toutefois, le référencement croisé d'une carte DITA s'avère finalement problématique.

Une carte DITA est une spécification pour un document publié ou pour une partie d'un document (si des cartes DITA imbriquées ou modulaires sont utilisées). En tant que telle, la carte DITA ne possède pas de contenu. Créer un lien vers une carte DITA est donc inutile. D'un point de vue logique, la référence croisée doit être liée à la première rubrique référencée par la carte DITA.

Malheureusement, la solution n'est pas aussi évidente. Par exemple, vous souhaitez insérer une référence croisée vers un chapitre, par exemple décrit dans le Chapitre 2. Les infrastructures du chapitre sont décrites dans la carte et, même si elles ne sont pas du contenu, elles peuvent être la cible d'une référence croisée. Dans tous les cas, les rubriques DITA sont destinées à être indépendantes du contexte. Par conséquent, insérer une référence croisée vers une carte DITA restreindrait cette utilisation des rubriques dans les publications où les cartes DITA référencées sont également inclues.

De plus, DITA ne possède pas de mécanisme clair pour insérer des références croisées dans les éléments topicref de la carte DITA.

Évitez donc d'insérer des références croisées vers les cartes DITA. Si nécessaire, il vaut mieux insérer une référence croisée vers la version publiée de la carte DITA, comme l'emplacement du PDF ou l'URL.