Qu'est-ce qu'une rubrique ?
Dans le langage DITA, une rubrique est un ensemble d'informations indépendant se référant à une idée ou une tâche, rédigé en tant qu'unité, et stocké dans un seul fichier. Les différentes rubriques sont catégorisées selon le type d'informations qu'elles contiennent. Grâce au modèle d'architecture DITA basé sur des rubriques, une même rubrique peut être utilisée dans différentes publications.
Le langage DITA est conçu à partir d'une architecture de l'information basée sur des rubriques. Les rubriques sont les éléments de base des documents DITA. L'approche de DITA ressemble beaucoup aux méthodes de la plupart des systèmes hypertexte, également basés sur des rubriques.
Selon le standard DITA Architectural Specification (spécification architecturale), la définition d'une rubrique est la suivante :
Une rubrique est une unité d'information composée d'un titre et d'un contenu. Elle doit être suffisamment courte pour être spécifique à un sujet unique ou pour répondre à une seule question, mais elle doit être également suffisamment longue pour être significative en soi et rédigée en tant qu'unité.
Selon DITA, le rédacteur rédige une rubrique indépendamment de l'ouvrage dans lequel la
rubrique peut être publiée (l'ouvrage est créé à partir de l'assemblage des rubriques
dans une structure hiérarchique et de la publication
de la collection de
rubriques dans un format de lecture). Cette méthode de rédaction basée sur les
rubriques porte l'accent sur la modularité et la réutilisation d'unités
d'information concises.
Une rubrique est créée en tant que bloc d'information autonome, contenant généralement une seule idée. Une rubrique bien rédigée transmet intégralement cette même idée en une seule lecture. Techniquement, une rubrique DITA peut être très minimaliste (composée juste d'un titre, par exemple), mais elle doit toujours transmettre une idée dans son intégralité. Chaque rubrique doit être stockée dans un seul fichier et catégorisée selon différents types d'information.
Même si les rubriques peuvent être séparées en différentes sections, les sections ne doivent pas être utilisées comme une alternative aux rubriques. Les sections doivent uniquement être employées lorsque l'idée à transmettre dans une rubrique est complexe. Cependant, utiliser des sections au lieu des rubriques nuit au principe de modularité.