L'élément topichead

L'élément topichead d'une carte DITA permet de créer, dans la hiérarchie, un nœud composé uniquement d'un titre, au sein duquel les références aux rubriques normales sont imbriquées. Bien qu'il soit valide d'un point de vue technique, cet élément ne devrait pas être utilisé car il génère un document de sortie incohérent.

L'élément topichead de la carte DITA permet de créer un nœud parent dans la hiérarchie sans qu'une rubrique correspondante soit nécessaire.

Il est conseillé d'éviter d'utiliser l'élément topichead dans votre carte DITA finale. Cependant, il peut s'avérer utile lors de la rédaction du brouillon ou lors de l'organisation de la structure de votre collection.

Il est préférable d'éviter les éléments topichead pour deux raisons.

Premièrement, ils entrent en conflit avec la notion de séparation du contenu et de la forme, et de la séparation des données et des métadonnées. Tous les contenus (données) d'un document doivent se situer dans les rubriques, et non dans la carte. La carte DITA doit contenir uniquement des métadonnées. Si vous utilisez un élément topichead comme alternative à une rubrique composée uniquement d'un titre, cela signifie que vous insérez du contenu ou des données non réutilisables dans la carte DITA.

La deuxième raison est d'avantage d'ordre pratique. Si vous transformez une carte DITA en sortie hypertexte avec une table des matières (par exemple pour Eclipse Help), les éléments topichead seront transformés en nœuds parents non liés dans la table des matières. Lorsque l'utilisateur clique sur un tel nœud, la rubrique associée ne s'affichera pas comme pour les autres nœuds de la table des matières. Pour l'utilisateur, cette incohérence est une erreur. Le nœud non lié à la table des matières génèrera également des incohérences ou des dysfonctionnements au niveau du fil d'Ariane et des séquences (liens vers les rubriques précédentes et suivantes).