L'élément coderef

L'élément coderef sert à référencer des fichiers tels que les exemples de code, qui sont importés lors de la publication pour être convertis en texte standard. L'élément codeblock est une alternative à l'élément lorsque le code est stocké ou mis à jour dans sa forme originale hors de la source DITA.

L'élément coderef, introduit dans DITA 1.2, est un élément de référence comme xref et conref. Il permet la transclusion de XML et d'autres blocs de code de fichiers externes.

Par exemple, vous pouvez souhaiter inclure un échantillon de code HTML sauvegardé dans un fichier HTML. Lorsque l'élément coderef est traité, le fichier de code référencé est importé, préservé (les caractères de balisage tels que < sont affichés, et non traités comme des instructions DITA) et publié de la même façon qu'un élément statique codeblock.