Variables utilisant l'indirection

L'élément keyword peut être utilisé en tant que conteneur pour les mots ou les phrases variables, lorsqu'il est utilisé conjointement avec l'élément keydef dans la carte DITA. Au lieu d'entrer la valeur du mot-clé directement dans l'élément, il vous est possible de le référencer indirectement par l'intermédiaire d'une clé.

La fonction keyref introduite dans DITA 1.2 permet de gérer plus facilement les locutions ou termes réutilisés, qui varient souvent selon la publication. Il vous est possible de rassembler les variables de termes à l'intérieur d'une section keydef présente dans la carte DITA, puis d'utiliser l'élément keyword et son attribut keyref pour les réutiliser. Vous devez également désigner une valeur de repli, au cas où la clé utilisée ne serait définie dans aucune carte DITA où la rubrique est référencée.

Puisque le modèle de contenu de l'élément keyword dans une carte DITA se présente différemment dans une rubrique, vous devez placer l'élément keyword de la carte DITA à l'intérieur des éléments topicmeta et keywords.

Prenons un exemple simple : une rubrique sur une pièce détachée générique peut comporter le nom de la voiture spécifique qui a recours à cette rubrique dans son manuel. La rubrique pourra comporter une telle phrase : 
Votre <keyword keyref="nom_voiture">voiture<keyword> possède des phares à décharge à haute intensité.
Si cette rubrique est enregistrée dans une carte DITA avec une clé ainsi définie : 
<keydef keys="nom_voiture">
  <topicmeta><keywords><keyword>Liberty</keyword></keywords></topicmeta>
</keydef>
La rubrique apparaîtra alors ainsi : 
Votre Liberty possède des phares à décharge à haute intensité.

Dans cet exemple, si la carte DITA n'avait aucune définition pour la clé nom_voiture, le mot voiture, ici valeur de l'élément keyword dans la rubrique, aurait été utilisé comme valeur par défaut.

Remarque : Il peut vous paraître plus simple de gérer les clés dans une carte DITA en utilisant une carte DITA imbriquée et différente afin de n'enregistrer que les clés.