The <bookmap> element is a map specialization used to describe the relationships among a set of DITA topics intended to be configured as a traditional book. Bookmaps consist of references to topics organized as book content. The topic references therefore are labeled according to the book components they point to, such as book title, front matter, chapter, and appendix.

Content models

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


- map/map bookmap/bookmap


<bookmap xml:lang="en-us">
    <booklibrary>Books about stuff</booklibrary>
    <mainbooktitle>A book about one thing</mainbooktitle>
    <bookabstract href="MyBookAbstract.dita"/>
    <preface href="preface.dita"></preface>
  <chapter href="chapter1.dita">
    <topicref href="subchap1.dita"></topicref>
  <chapter href="chapter2.dita">
    <topicref href="subchap2.dita"></topicref>
  <appendix href="app1.dita">
    <topicref href="insideApp1.dita"></topicref>
  <appendix href="app2.dita">
    <topicref href="insideApp2.dita"></topicref>
    <amendments href="updatesToTheBook.dita"/>
      <trademarklist href="listoftrademarks.dita"/>


The following attributes are available on this element: Universal attribute group (with a narrowed definition of @id, given below), Attributes common to many map elements, Architectural attribute group, outputclass, and the attributes defined below. This element also uses @type, @scope, and @format from Link relationship attribute group.

Allows an ID to be specified for the map. Note that maps do not require IDs (unlike topics), and the map ID is not included in references to elements within a map. This attribute is defined with the XML Data Type ID.
Identifies a location within another map document where this map will be anchored. Resolution of the map is deferred until the final step in the delivery of any rendered content. For example, anchorref="map1.ditamap#a1" allows the map with @anchorref to be pulled into the location of the anchor point "a1" inside map1.ditamap when map1.ditamap is rendered for delivery.

Return to main page.