Types de collection

L'attribut collection-type de l'élément topicref définit la relation qui existe entre les rubriques de référence imbriquées dans une carte DITA. La modification du type de collection influe sur le mode de génération des liens automatiques et des aperçus de rubriques lors de la publication de la carte DITA.

Le mode de génération des liens lors du traitement de sortie dépend de l'attribut collection-type des éléments topicref parents dans la section hiérarchie de la carte DITA ou dans la section reltable contenant l'élément relcell. (Un topicref parent contient des élémentstopicref imbriqués ou des nœuds enfants). Par conséquent, l'attribut collection-type définit le type de relation hiérarchique existant entre les membres de la même branche d'un arbre d'une carte DITA ou de la même cellule de l'élément relcell.

Dans DITA, il existe cinq types de collections :
unordered :
une collection de rubriques dans laquelle sont générés les liens parents-enfants et enfants-parents.
family :
une collection de rubriques dans laquelle sont générés les liens parents-enfants, enfants-parents et éléments frères-éléments frères.
sequence :
une collection de rubriques dans laquelle sont générés les liens parents-enfants, enfants-parents, enfant-frère précédent (le cas échéant) et enfant-frère suivant (le cas échéant).
choice :
ce type de collection n'est pas souvent utilisé, mais elle est destinée aux situations dans lesquelles le lecteur doit choisir une rubrique enfant pour poursuivre. Cela peut s'avérer utile lorsque le document de sortie est une application décisionnelle interactive. La plupart des processeurs traitent la collection choice de la même manière que le répertoire unordered.
tree :
le type de collection tree n'est pas pris en charge.

Exemple de syntaxe : <topicref href="abc.dita" collection-type="sequence" />

Bien que les attributs collection-type soient valides dans la table des relations des éléments relcell, l'utilisation de certains de ces éléments n'a pas beaucoup de sens dans ce contexte.

Par exemple, configurer un collection-type dans une cellule de la table des relations sur sequence aboutit à la création d'un lien Rubrique suivante dans le lien de sortie vers la rubrique suivante référencée de la cellule plutôt que vers la rubrique suivante de la séquence de la table des matières (comme le lecteur pourrait logiquement s'y attendre).

Même s'il est possible de définir un attribut collection-type de sequence pour l'élément relcell, ceci est généralement source de confusion pour l'utilisateur, dans la mesure où ceci crée une séquence de rubrique distincte de la séquence de rubrique de la hiérarchie. La même logique s'applique à la valeur de l'attribut choice. C'est pour ces raisons qu'il faut éviter d'utiliser les valeurs de l'attribut collection-type de sequence et de choice, sauf pour créer des documents dotés de chemins de navigation multiples.

Par ailleurs, un reltable n'a généralement pas de relation parent-enfant similaire à celle de la section hiérarchie de la carte. C'est pourquoi l'utilisation d'un type de répertoire family n'a aucun sens dans les reltables.