Paragraphes (et autres éléments bloc) dans les tableaux

Évitez d'utiliser des éléments bloc dans des tableaux standards. Utilisez des éléments bloc enfants uniquement lorsqu'une cellule du tableau contient plusieurs idées, plusieurs faits ou plusieurs points. N'utilisez pas les éléments bloc dans les tableaux simples.

Dans DITA, les cellules d'un tableau contiennent généralement du texte brut (techniquement, des données de chaînes de caractères). Cependant, les cellules peuvent aussi contenir des paragraphes, des listes ou d'autres éléments bloc (données de bloc). Cette caractéristique laisse aux auteurs la liberté d'insérer dans les cellules soit du texte brut, soit des paragraphes.

Par exemple, la cellule d'un tableau simple peut être codée en tant que données de chaînes de caractères <stentry>moteur de 2,5 litres</stentry> ou en tant que données de bloc <stentry><p>moteur de 2,5 litres</p></stentry>. Il est également possible que le contenu d'un tableau soit mixte, c'est à dire un tableau qui contienne à la fois des données de chaînes de caractères et des données bloc. Dans ces tableaux, certaines cellules contiennent du texte brut et d'autres contiennent des paragraphes.

La meilleure méthode consiste à utiliser le moins de balises possible.

Si une cellule contient seulement un bloc de texte, elle doit alors être codée comme contenant des données de chaînes de caractères. Cela permet de conserver un minimum de balises et de simplifier le traitement du fichier de sortie. Si la cellule contient des blocs multiples, il faut utiliser des paragraphes (ou d'autres éléments bloc). Une cellule ne doit pas contenir à la fois des données de chaînes de caractères et des données bloc.

S'il est nécessaire d'inclure des éléments bloc dans une cellule, toutes les cellules doivent alors contenir les mêmes éléments. En utilisant des méthodes de balisage mixte (blocs dans certaines cellules, chaînes de caractères dans d'autres), le rendu de la sortie risque d'être incohérent.

Les tableaux simples (éléments simpletable), notamment, doivent être simplifiés au maximum. S'il est nécessaire d'inclure un élément bloc dans la cellule d'un tableau, le tableau doit être codé comme un tableau standard et non comme un tableau simple.