Créer des liens indirects avec des clés

Créer des liens ou des références indirectes consiste à définir la cible d'un lien ou d'une référence dans la carte DITA plutôt que dans la rubrique. Cette fonctionnalité, apparue dans DITA 1.2, permet de définir différentes destinations pour les liens en fonction de la carte DITA avec laquelle la rubrique est utilisée.

L'indirection est une méthode de création de liens indirects qui a été introduite dans DITA 1.2. Au lieu de renvoyer à l'adresse de la ressource, vous renvoyez à une clé, qui à son tour renvoie à l'adresse de la ressource. Puisque la clé peut être stockée séparément de la rubrique dans la carte DITA, le même lien ou la même référence d'une rubrique peut renvoyer à des cibles différentes selon la carte DITA utilisée.

Cette méthode permet de:

  • Rediriger un lien vers une nouvelle cible en cas de redéfinition dans la carte DITA.
  • Rediriger un élément conref vers une nouvelle cible.
  • Ajouter du texte à un élément term ou un élément keyword.
  • Transformer des éléments term en liens.

Les valeurs de l'attribut keys sont définies dans la carte DITA par la syntaxe key="target URI". Pour référencer une clé dans une rubrique, en général dans un élément de référence croisée (xref), term ou image, utilisez l'attribut keyref au lieu de l'attribut direct href. La méthode de création de liens indirects peut également servir à la transclusion de référence de contenu en utilisant l'attribut conkeyref au lieu de l'attribut direct conref.

Si la clé référencée dans un attribut keyref n'est pas définie dans la carte DITA, la cible redevient la valeur de l'attribut href, si celle-ci est définie.

Dans l'exemple ci-dessous, si la clé de référence croisée alpha n'est pas définie dans la carte DITA, le lien généré renverra à abc.dita. 
<xref keyref="alpha" href="abc.dita">Alpha</xref>
Si la clé alpha existe, l'attribut href est ignoré. (L'attribut keyref prévaut sur l'attribut href.)
Figure 1: Schéma de la méthode de création de liens indirects

Diagramme représentant la façon dont les attributs key et keyref sont utilisés pour rediriger un lien à partir de la méthode d'indirection

Cette méthode de création de liens indirects permet de retirer de la rubrique les informations de contexte pour les stocker dans la carte, ce qui facilite ainsi la réutilisation de la rubrique.