21.4. appendix

L'élément <appendix> référence un thème comme annexe dans un livre.

Exemple

Thèmes d'annexe comprenant des sous-thèmes :

<appendix href="intro.dita">
 <topicref href="caring.dita" />
 <topicref href="feeding.dita" />
</appendix>
<appendix href="setup.dita">
 <topicref href="prereq.dita" />
 <topicref href="download.dita" />
</appendix>

Annexe référençant une carte ditamap de contenu :

<appendix href="intro.ditamap" format="ditamap" />

Contient :

Doctype Modèle de contenu
bookmap ( ( topicmeta) (optionnel) puis ( topicref ou topichead ou topicgroup) (un nombre quelconque) )

Contenu par :

Doctype Parents
bookmap bookmap

Héritage :

- map/topicref bookmap/appendix

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
navtitle Spécifie le titre du thème tel qu'il apparaîtra dans la navigation ou les tables des matières générées à partir de la carte. CDATA #IMPLIED non
href Un hyperlien vers une page web externe (adresse URL) ou une autre ressource non-DITA, ou vers un autre thème DITA dans le même fichier ou dans un autre fichier. L'attribut format identifie le format de la cible. Les cibles non-DITA utilisent une syntaxe URL standard. Les thèmes DITA sont ciblés comme suit.

Cible ailleurs dans le même fichier :

  href="#topicid"

Premier thème dans un fichier différent :

  href="filename.dita"

Thème spécifique dans un fichier différent :

  href="filename.dita#topicid"

Si l'adresse URL contient un caractère ESPERLUETTE « & », on devrait utiliser son symbole (&amp;) pour indiquer ce caractère

CDATA #IMPLIED non
copy-to Utilisez l'attribut copy-to sur l'élément <topicref> pour fournir un nom de fichier différent pour une instance particulière du thème dans la carte (par exemple, pour distinguer les différentes versions du thème plutôt que de les combiner à la sortie). Les liens et la navigation associés à cette instance pointeront vers une copie du thème avec le nom de fichier spécifié.

Utilisez les éléments <linktext> et <shortdesc> dans l'élément <topicmeta> du <topicref> pour fournir un nom unique et une description courte pour la nouvelle copie.

CDATA #IMPLIED non
%topicref-atts; (collection-type, type, scope, locktitle, format, linking, toc, print, search, chunk) Un ensemble d'attributs liés. Cf. la section 25.8. %topicref-atts; et %topicref-atts-no-toc;. entité paramètre sans objet pour une entité paramètre sans objet
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) Un ensemble d'attributs liés, décrit à la section 25.7. %univ-atts; entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, outputclass, keyref Attributs communs, décrit à la section 25.9. Autres attributs DITA communs