L’attribut conref

Un conref renvoit directement à un élément réutilisé à l’aide de trois informations :

• L’emplacement de la rubrique contenant l’élément référencé
• L’id de la rubrique contenant l’élément référencé
• L’id de l’élément référencé

Le chemin vers le fichier et la rubrique id sont séparés un dièse (#) ; L’id de la rubrique et de l’élément sont séparés par un slash (/).

Note: Si l’élément référencé est présent dans le même fichier que l’élément référençant (ce qui est rare), le chemin vers le fichier peut être optionnel, mais le dièse (#) doit être ajouté.

Par exemple, une rubrique partagée (que l’on peut trouver dans ../commun/avertissement.dita) contient un élement <note>.

<topic id="avertissementcommun">
   ...
   <note type="danger" id="dangerchaleur">La surface est brûlante.</note>
   ...

Pour réutiliser cette <note> dans une autre rubrique, vous devez créer dans la rubrique une <note> vide, puis ajouter l’attribut conref pour identifier où sera réutilisé le contenu

...
<note conref="../commun/avertissement.dita#avertissementcommun/dangerchaleur"/>
...

Le contenu de l’attribut conref peut sembler intimidant ou difficile à retenir. Néanmoins, la plupart des éditeurs DITA assiste l’utilisateur pendant la mise en place d’un conref.

Le tableau suivant montre quelques exemples du formatage de la valeur de l’attribut conref dans plusieurs situations. Dans ces exemples, vous remplacerez les informations génériques :

Contributors

• Mike Rice, easyDITA
• Annie Chen, easyDITA
• Simon Bate, Scriptorium
• Decarnelle Rémi (traducteur)