Spécialisation

La spécialisation permet de créer ses propres types de documents sans perdre les avantages de l'architecture DITA. Elle permet notamment de maintenir l'interchangeabilité des contenus.

Bien que la spécialisation soit un élément clé de DITA, cette fonctionnalité n'est pas encore très largement utilisée. Elle est souvent perçue comme compliquée et technique. Si la spécialisation est rarement utilisée alors qu'elle le devrait, l'inverse est aussi vrai : les organisations ont parfois recours à la spécialisation inutilement.

La spécialisation consiste à définir ses propres éléments et attributs sémantiques ou types d'information pour répondre aux besoins spécifiques des modèles de contenu (la nature du type d'information). Un élément spécialisé est toujours basé sur un autre élément DITA, de sorte qu'il faut simplement définir la façon dont l'élément diffère de celui sur lequel il se base (son ancêtre).

Une spécialisation doit se faire dans le respect strict des règles de spécialisation DITA. En d'autres termes, il s'agit d'un processus formel et défini par des règles spécifiques. Une spécialisation est définie par des modules DTD ou XSD qui étendent les possibilités des DTD et des XSD de base de DITA.

Les organisations choisissent de spécialiser DITA si elles souhaitent que leurs documents suivent une structure qui leur est spécifique ou contiennent des métadonnées qui leurs sont propres.

Voici un exemple de spécialisation reflétant une structure (ou un modèle de contenu) particulière : l'organisation doit utiliser une variante d'une rubrique de type référence et qui doit contenir des numéros de pièces, des poids, des prix de gros et des prix de vente. La rubrique de type référence de base a une structure différente qu'il est possible de spécialiser à l'aide des éléments suivants : num_piece, poids_unite, prix_gros et prix_vente.

Voici un exemple de spécialisation de métadonnées : l'organisation souhaite enregistrer le numéro d'employé du programmeur responsable du module logiciel qui est documenté dans la rubrique, dans un attribut nommé numero_employe.

Tout élément ou attribut spécialisé doit se spécialiser à partir d'un autre élément DITA. Ce dernier devient ainsi le ancêtre de l'élément spécialisé.

Si le processeur ne connaît pas le type d'information spécialisé, il traitera la rubrique de la même façon que son ancêtre.

Pour échanger des rubriques avec quelqu'un qui n'utilise pas la spécialisation, il faudra peut-être généraliser les rubriques pour leur donner à nouveau la structure de leurs ancêtres. La généralisation peut être entièrement automatisée.

Voici quelques-unes des règles de spécialisation dans DITA :
  • La spécialisation ne peut pas être plus souple que les règles du modèle de contenu de base de DITA.
    • Il n'est pas possible de rendre facultatif un élément parent obligatoire ou un attribut obligatoire.
    • Il n'est pas possible d'autoriser des éléments dans les emplacements interdits par le modèle de contenu de base.
  • Il n'est pas possible d'ajouter de nouveaux attributs spécifiques à certains éléments. Vous pouvez uniquement créer de nouveaux attributs généraux (ou des attributs d'éléments) dans le modèle de contenu de base.

Ce Guide de Style DITA se concentre uniquement sur les éléments DITA standards.