Variables en utilisant l'attribut conref et le filtrage

La publication à partir d'une source unique (single-sourcing) repose largement sur le concept de variables. Bien que DITA n'ait pas de fonction nommée précisément variable, le standard supporte des fonctionnalités pour gérer des variables.

Dans le contexte de publication à partir d'une source unique, une variable est un élément qui est utilisé dans l'ensemble du contenu à la place d'un texte fixe habituel. Lorsque le document est publié, l'élément variable est remplacé par une phrase ou un bloc de texte défini. Les variables permettent d'effectuer de nombreuses modifications rédactionnelles sans le moindre effort.

Par exemple, une documentation peut être nécessaire pour un produit vendu sous deux noms de marque différents : Legend et Liberty. Au lieu de coder en dur le nom du produit, une variable nom_marque peut être utilisée à chaque fois que le produit est mentionné dans le texte. Durant l'édition de la documentation pour la marque Liberty, la variable nom_produit sera remplacée par le mot Liberty.

Dans DITA, les variables sont implémentées via les fonctions de filtrage conref et ditaval. La variable est codée comme étant un élément référencé : <ph conref="abc.dita#produit" />. L'élément source conref est codé avec des attributs de métadonnées qui peuvent être utilisés pour le filtrage, tels que :

<ph id="produit>
  <ph produit="Liberty">Liberty</ph>
  <ph produit="Legend">Legend</ph>
</ph>

Lors de l'édition du contenu, le filtrage conditionnel dans la ditaval peut être paramétré pour que seul l'élément du nom de produit applicable soit inclus dans la sortie.