Le type de rubrique générique

Tous les types de rubriques DITA sont basés sur un seul type de rubrique générique. Le type de rubrique générique est utilisé comme base pour créer les types de rubriques. De nombreux éléments et l’organisation de la rubrique générique sont également utilisés par les types de rubriques spécifiques.

Toutes les rubriques DITA ont cette structure générale :

<topic id="sample">
   <title>Le titre de la rubrique vient ici</title>
   <shortdesc>Une courte description</shortdesc>
   <body>
        (La plupart des éléments viennent ici.)
   </body>
</topic> 
  • L’élément <shortdesc> (courte description) fourni un résumé du contenu de la rubrique en 2-3 phrases.
  • L’élément <title> est le seul élément requis dans une rubrique.
  • L’élément <body> contient la majeure partie des informations de la rubrique. Dans les types de rubriques spécifiques, l’élément body a un nom associé, tel que <conbody> pour les concepts et <taskbody> pour les tâches.

Remarque : Bien que vous puissiez utiliser le type de rubrique générique pour la création de contenu, il est préférable d’utiliser l’un des types de rubriques spécifiques, tels que concept, tâche et référence.

Il existe d’autres éléments dans le type de rubrique générique, mais ce sont les plus courants.

Contributeurs