`<chapter>`

The <chapter> element references a topic or map as a chapter within a book.

Content models

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

Inheritance

- map/topicref bookmap/chapter

Example

Chapter topics that include subtopics:

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

Chapter that references a ditamap of content:

<chapter href="intro.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.