The <part> element references a part topic or a map that references part topics for the book. Use <part> to divide a document's chapters into logical groupings. For example, in a document that contains both guide and reference information, you can define two parts, one containing the guide information and the other containing the reference information.

Content models

See appendix for information about this element in OASIS document type shells.


- map/topicref bookmap/part


Part topics that include chapters and subtopics:

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

Parts that reference ditamaps of content:

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


The following attributes are available on this element: Universal attribute group, Link relationship attribute group (with a narrowed definition of @href, given below), Attributes common to many map elements, @navtitle and @copy-to from Topicref element attributes group, @outputclass, and @keyref.

A pointer to the resource represented by the <topicref>. See The @href attribute for detailed information on supported values and processing implications. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the @format attribute to identify the kind of resource being referenced.

Was this helpful?