Distinction entre style et mise en forme, données et métadonnées

Dans DITA, style n'est pas synonyme de format et données et métadonnées sont également bien distinctes. Il est important de bien différencier les uns et les autres pour assimiler les principes de séparation du contenu et de la forme.

Le terme style comme dans le Guide de style pose problème car il prend plusieurs sens légèrement différents. En effet, le terme style peut faire référence à la présentation esthétique de l'information mais il peut également faire référence au style d'écriture ou de formulation. Un style peut être propre et clair (esthétiquement) tout en étant lourd et redondant (stylistiquement).

Pour distinguer les deux styles, utilisez le terme mise en forme (ou style de présentation) pour faire référence à l'esthétisme ou à l'aspect du document livrable. Utilisez le terme style pour désigner le style de l'auteur.

Dans le cadre plus large de la séparation du contenu et de la forme, le style relève du contenu, tandis que le format relève de la mise en forme.

Le Guide de Style DITA s'intéresse au style d'écriture mais n’aborde pas du tout la mise en forme. Il se concentre sur le balisage sémantique, qui n'est pas inclus dans les guides de style classiques.

Il est aussi important de bien faire la distinction entre données et métadonnées. Les données relèvent du contenu, alors que les métadonnées sont des informations à propos du contenu.

Par exemple, les données d'une rubrique sont les informations que le lecteur lit et qui traitent du sujet de cette rubrique. Les métadonnées sont les informations qui caractérisent la rubrique et que le lecteur ne lit pas ou ne voit pas habituellement, telles que la date de création de la rubrique, le nom de l'auteur, la sémantique des composants textuels et les droits d'auteur. Les métadonnées sont généralement plus importantes pour le rédacteur que pour le lecteur.

Si les métadonnées, comme les données, sont présentes dans les rubriques, les cartes DITA doivent contenir uniquement des métadonnées. (Il est techniquement possible d'enregistrer quelques données dans des cartes DITA, mais c'est une pratique qu'il faut éviter.)