Un conref contient deux parties
- L’ élément référencé qui contient le contenu que vous souhaitez réutiliser. Cet élément doit avoir un attribut id.
- L’ élément référençant qui indique où sera réutilisé le contenu.
Note: Si le contenu que vous souhaitez réutiliser n’a pas d’id, votre éditeur DITA ou CMS vous demandera d’en créer un pendant la procédure de réutilisation. Un id doit commencer par une lettre, un chiffre ou un underscore (_).
Tip: L’acception du terme conref comme verbe est « réutiliser du contenu grâce à la balise conref »
Les conrefs sont résolus lors de la génération de la publication par un transformateur. De nombreux éditeurs DITA résolvent les conrefs pendant la rédaction afin d’avoir un rendu proche du résultat final.
Pour résoudre un conref, le transformateur remplace l’élément référençant par l’élément référencé et tout son contenu. Cela inclut tous les éléments au sein de l’arborescence du contenu référencé. Par exemple, si la balise <p> référencé contient une balise <uicontrol>, le <p> référençant sera remplacé par le <p> référencé en incluant le <uicontrol>. De la même façon, un liste <ol> référencée incluera tous les éléments <li> en son sein.
Quand le contenu original change, ces modification apparaissent partout là où le contenu a été réutilisé.
Contributors
- Mike Rice, easyDITA
- Annie Chen, easyDITA
- Simon Bate, Scriptorium
- Decarnelle Rémi (traducteur)