21.23. part

L'élément <part> référence un thème de partie du livre. Une nouvelle partie commence. Utilisez <part> pour diviser les chapitres d'un livre en regroupements logiques. Par exemple, dans un document qui contient à la fois un guide et des références, on peut définir deux parties, l'une contenant le guide et l'autre les références.

Exemple

Thèmes de partie incluant des chapitres et des sous-thèmes :

<part href="guide.dita">
 <chapter href="intro.dita">
  <topicref href="caring.dita"/>
  <topicref href="feeding.dita"/>
 </chapter>
 <chapter href="setup.dita">
  <topicref href="prereq.dita"/>
  <topicref href="download.dita"/>
 </chapter> 
</part>
<part href="ref.dita">
 <chapter href="commands.dita">
  <topicref href="care.dita"/>
  <topicref href="feed.dita"/>
 </chapter>
 <chapter href="apis.dita">
  <topicref href="acare.dita"/>
  <topicref href="afeed.dita"/>
 </chapter> 
</part>

Parties qui référencent des cartes de contenu ditamap :

<part href="intro.ditamap" format="ditamap"/>
<part href="guide.ditamap" format="ditamap"/>

Contient :

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

Contenu par :

Doctype Parents
bookmap bookmap

Héritage :

- map/topicref bookmap/part

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