Référencement indirect de contenu

La fonction keyref a été introduite dans DITA 1.2 pour permettre le référencement indirect dans les liens, les images et les références de contenu. Plutôt que de référencer directement un élément dans l'attribut conref, il vous est possible de référencer une clé, dont la destination est définie dans la carte DITA.

Dans certains cas, il peut s'avérer nécessaire de référencer différents textes selon le contexte de la publication. Par exemple, lorsque vous publiez un guide utilisateur destiné au marché australien, vous souhaitez y inclure le numéro de téléphone du bureau australien, mais lorsque vous publiez à destination du marché néo-zélandais, vous souhaitez inclure le numéro de téléphone du bureau néo-zélandais. Dans ce cas précis, il vous est possible d'utiliser la publication conditionnelle, mais il reste bien plus facile d'utiliser la fonction keyref.

Le procédé consiste à utiliser un attribut conkeyref afin de référencer une clé dans la rubrique qui contient les éléments réutilisables, et l'attribut id de l'élément réutilisable, en utilisant la syntaxe key/id.

Par exemple, au lieu d'utiliser <ph conref="conref_contacts.dita#contacts/tel_aus" />, vous pourriez utiliser le code <ph conkeyref="reuse/tel_bureau" />. Dans la carte DITA du guide utilisateur australien, vous pourriez définir l'URI de la rubrique avec une clé reuse dans le contexte australien, par exemple <topicref keys="reuse" href="reuse_aus.dita"/>. Dans la carte DITA du guide utilisateur néo-zélandais, vous pourriez définir une clé reuse du type <topicref keys="reuse" href="reuse_nz.dita"/>. Les deux rubriques devraient contenir un élément phrase (ph) avec un attribut id tel_bureau, qui contiendrait les numéros de téléphone respectifs.