part

Darwin Information Typing Architecture (DITA) Version 1.3 Part 3: All-Inclusive Edition

version
1.3
author
OASIS DITA Technical Committee

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.

Inheritance

- map/topicref bookmap/part

Example

Part topics that include chapters and subtopics:
<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>
Parts that reference ditamaps of content:
<part href="intro.ditamap" format="ditamap"/>
<part href="guide.ditamap" format="ditamap"/>

Attributes

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.

href
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.