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>
Voici un exemple plus complexe :
<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.

Figure 1: Comparaison entre les listes parallèles et les listes imbriquées

Diagramme présentant la différence entre les listes et phrases d'introduction parallèles et les listes imbriquées dans la phrase d'introduction d'un paragraphe

Remarque : Certaines exigences entrent en conflit lorsque le contenu doit être localisé. Insérer un bloc imbriqué dans un paragraphe, comme dans les exemples précédents, peut poser problème pour les traducteurs. Il s'agit d'un vrai dilemme, qui pourrait finalement être résolu grâce au développement des outils logiciels. Si vous rédigez un document qui sera traduit, évitez d'insérer du texte après un bloc imbriqué dans un autre. Lorsque vous rédigez un document qui sera traduit, suivez les lignes directrices du livre Best Practice for Leveraging Legacy Translation Memory when Migrating to DITA (Joseph & Raya, 2007) produit par le sous-comité d'OASIS consacré à la traduction.