Utilisation avancée des clés

Utilisation hybride de l’élément <keydef>

Vous pouvez utiliser l’élément <keydef> à la fois pour des chemins de fichier ou des chaînes de caractères. Imaginez une situation dans laquelle vous avez besoin de référence croisée d’une rubrique à différents endroits. Dans ce cas, vous pouvez créer un élément <keydef> qui associe une clé à un attribut href pointant vers une rubrique et dans lequel est imbriqué un élément <topicmeta> et ensuite <linktext> :

<keydef keys="initialiser_bdc" href="init_bdc.dita">
    <topicmeta>
        <linktext>Initialiser la Base de données canards</linktext>
    </topicmeta>
</keydef>
Si vous référencez cette clé à l’aide d’une référence croisée, soit l’élément <xref>, le lien ciblera le fichier init_bdc.dita et le texte du lien sera ajouté à l’emplacement de votre xref, soit « Initialiser la Base de données canards » :

<xref keyref="init_bdc.dita"/>

Keyref avec scénario de secours

Si vous utilisez les attributs keyref et href avec le même élément, le transformateur essayera de résoudre le keyref en priorité. Si la clé n’est pas définie, alors le href sera resolu comme scénario de secours.

Contributors