chapter

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

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

Contains

Doctype	Content model
bookmap	( ( topicmeta) (optional) then ( topicref or topichead or topicgroup) (any number) )

Contained by

Doctype	Parents
bookmap	bookmap, part

Inheritance:

- map/topicref bookmap/chapter

Attributes

Name	Description	Data Type	Default Value	Required?
navtitle	Specifies the title of the topic as it will appear in navigation or tables of contents generated from the map.	CDATA	#IMPLIED	No
href	A hyperlink to an external Web page (URL) or other non-DITA resource, or to another DITA topic in the same file or in another file. The format attribute identifies the format of the target. Non-DITA targets use standard URL syntax. DITA topics are targetted as follows: Target elsewhere in the same file: href="#topicid" First topic in different file: href="filename.dita" Specific topic in different file: href="filename.dita#topicid" If the URL contains an ampersand character, the ampersand symbol (&) should be used to indicate that character	CDATA	#IMPLIED	No
copy-to	Use the copy-to attribute on the <topicref> element to provide a different file name for a particular instance of the topic in the map (for example, to separate out the different versions of the topic, rather than combining them on output). The links and navigation associated with that instance will point to a copy of the topic with the file name you specified. Use the <linktext> and <shortdesc> in the <topicref>'s <topicmeta> to provide a unique name and short description for the new copy.	CDATA	#IMPLIED	No
%topicref-atts; (collection-type, type, scope, locktitle, format, linking, toc, print, search, chunk)	A set of related attributes. See %topicref-atts; and %topicref-atts-no-toc;.	parameter entity	PE not applicable	Not applicable
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;)	A set of related attributes, described at %univ-atts;	parameter entity	PE not applicable	Not applicable
%global-atts; (xtrf, xtrc)	A set of related attributes, described at %global-atts;	parameter entity	PE not applicable	Not applicable
class, outputclass, keyref	Common attributes described in Other common DITA attributes