Listes au sein des paragraphes
Selon le contexte, une liste peut faire partie d'un paragraphe ou constituer un bloc parallèle distinct placé à la suite du paragraphe. Si le paragraphe contient une phrase d'introduction à une liste, alors cette liste est liée au paragraphe. Elle doit être un élément enfant de ce paragraphe.
DITA vous permet de structurer une liste d'éléments au sein d'un élément paragraphe ou indépendamment de tout paragraphe. Pour plus de clarté, référez-vous aux codes ci-dessous, tous deux valides :
<p>
<ul>
<li>Point 1</li>
<li>Point 2</li>
</ul>
</p>
et
<ul>
<li>Point 1</li>
<li>Point 2</li>
</ul>
Vous devez choisir, selon le contexte, la structure sémantique correcte.
Dans la plupart des cas, la seconde option (structure de liste autonome) est sémantiquement correcte, car la plupart des listes ne peuvent pas être insérées de manière logique au sein d'un paragraphe. De plus, si le paragraphe est constitué uniquement de la liste, il est probablement superflu.
Toutefois, dans certains cas, la liste peut être logiquement intégrée à l'idée présente dans le paragraphe qui l'englobe. Dans de tels cas, l'élément paragraphe peut contenir du texte avant et/ou après l'élément liste, par exemple :
<p>Les quatre modèles de turbocompresseurs sont les suivants :
<sl>
<sli>XRW ;</sli>
<sli>XRW Super ;</sli>
<sli>Lumberer XT ;</sli>
<sli>Liberty GT.</sli>
</sl>
</p>
<p>Les quatre modèles de turbocompresseurs :
<sl>
<sli>XRW,</sli>
<sli>XRW Super,</sli>
<sli>Lumberer XT,</sli>
<sli>Liberty GT,</sli>
</sl>
sont les plus coûteux de cette série.</p>
Le paragraphe de l'exemple précédent peut faire l'objet d'une réutilisation de contenu et dans ce cas, inclure systématiquement la liste, puisqu'elle fait partie de la même idée. La liste peut être réutilisée sans le texte du paragraphe, mais le texte du paragraphe ne peut pas être réutilisé sans la liste.
Certaines personnes traitent les différentes phrases d'introduction de la même façon. Si une phrase d'introduction se termine par deux-points, alors elle doit être réutilisée uniquement accompagnée de la liste qui lui est associée. La phrase d'introduction et la liste doivent donc se trouver dans le même élément sémantique.