Une rubrique DITA est l’unité de base de la création et de la réutilisation.
Dans la création thèmatique, vous créez un certain nombre de rubriques individuels, chacune abordant une idée ou répondant à une question. Ces rubriques peuvent ensuite être utilisées et réutilisées dans n’importe quel ordre, dans différents documents. Dans DITA, les rubriques sont organisées en cartes (map), qui ressemblent beaucoup à une table des matières ; la carte vous permet de spécifier l’ordre et la hiérarchie des rubriques.
Pour rendre vos rubriques réutilisables :
- Une rubrique doit aborder une seule idée ou répondre à une seule question.
- Une rubrique doit contenir suffisamment d’informations pour être autonome.
- Une rubrique ne devrait prendre aucun contexte. Vous ne devriez pas émettre d’hypothèses sur ce qui vient avant ou après la rubrique.
- Un seul fichier doit contenir une seule rubrique.
Toutes les rubriques DITA doivent avoir au moins un élément title et un attribut id à la racine de la rubrique. En d’autres termes, voici une rubrique DITA valide :
<topic id="exemple"> <title>Le titre de la rubrique vient ici</title> </topic>
Cependant, une rubrique utile aura un contenu supplémentaire.