Types de listes
Dans DITA, il existe quatre types de listes génériques sémantiquement distinctes. Chacune s'affiche différemment dans le document de sortie.
- Listes simples
- Une liste simple (sl) est une liste composée de phrases courtes dont l'ordre n'a pas d'importance. Dans le document de sortie, chaque élément de cette liste est généralement présenté sur une ligne séparée, sans puce ou chiffre.
- Listes à puce (non ordonnées)
- Une liste non ordonnée (ul) est une liste dans laquelle l'ordre des éléments qui la composent n'est pas important. Dans le document de sortie, chaque élément est généralement introduit par une puce. Ces éléments sont souvent des blocs de texte.
- Listes numérotées (ordonnées)
- Une liste ordonnée (ol) est une liste dans laquelle l'ordre des éléments qui la composent est primordial pour la signification. Dans le document de sortie, chaque élément est généralement présenté avec un numéro séquentiel.
- Listes de définitions
- Une liste de définitions (dl) est composée d'un ensemble de termes et de leurs définitions respectives. Dans le document de sortie, cette liste est présentée soit avec les définitions sur la ligne suivante, soit avec les définitions sur la même ligne.
Ces listes sont sémantiquement distinctes, bien que la différence entre une liste simple et une liste non ordonnée soit mineure. Certains processeurs peuvent publier des listes simples en tant que listes en ligne plutôt que comme listes sous forme de bloc (lignes distinctes pour chaque élément).
Les types de liste ne sont pas interchangeables ; le contenu de la liste déterminera quel type de liste est approprié. Choisissez le type de liste en fonction de la nature de cette liste et non de la manière dont elle sera publiée dans le document de sortie.
Bien que les listes simples soient techniquement valides au sein d'éléments de listes de définitions, ordonnées ou non ordonnées, évitez d'imbriquer des listes simples dans d'autres listes.
DITA inclut d'autres structures de listes spécifiques, telles que les listes de paramètres (parml) et les listes de choix (choices).