2.2.2.15 Bookmap

The DITA bookmap specialization represents the key markup requirements for managing DITA content through book-oriented publication processes, including book metadata and book structures for organizing content.

The purpose of the bookmap specialization

Books and other printed media are popular ways to present DITA content. By specializing the general DITA map structure into the general structure and subject areas used by most book-oriented DTDs, bookmaps enable users to organize their DITA information into front matter, parts, chapters, and so forth. A rich set of metadata allows for recording information about the book, such as its authors and owners, versions, and production history.

The structure of the bookmap specialization

The <bookmap> element is the top-level element for a DITA bookmap. Most of the content for a bookmap is optional, allowing for specializations that further restrict the bookmap model..

A bookmap allows the following parts:

In typical book-oriented DTDs or schemas, authors commonly manage major content structures as external entities, separate from the body of the book, and referenced as imbedded elements into the overall structure. Bookmap follows the same organizational approach, using the topicref-based structure of DITA maps as the archetype for the major divisions of a book.

Here is an example of a simple bookmap. It includes several mechanisms to include chapter content:

<bookmap id="taskbook">
  <booktitle>
    <mainbooktitle>Product tasks</mainbooktitle>
    <booktitlealt>Tasks and what they do</booktitlealt>
  </booktitle>
  <bookmeta>
    <author>John Doe</author>
    <bookrights>
      <copyrfirst>
        <year>2006</year>
      </copyrfirst>
      <bookowner>
        <person href="task_preface.dita>Jane Doe</person>
      </bookowner>
    </bookrights>
  </bookmeta>
  <frontmatter>
    <preface/>
  </frontmatter>
  <chapter format="ditamap" href="installing.ditamap"/>
  <chapter href="configuring.dita"/>
  <chapter href="maintaining.dita">
    <topicref href="maintainstorage.dita"/>
    <topicref href="maintainserver.dita"/>
    <topicref href="maintaindatabase.dita"/>
  </chapter>
  <appendix href="task_appendix.dita"/>
  </bookmap>
Modules

The following DITA modules are provided for the bookmap specialization.

bookmap.dtd, bookmap.ent, bookmap.mod (DTD)

bookmap.xsd, bookmapGrp.xsd, bookmapMod.xsd (Schema)

Previous Topic:  2.2.2.14 Glossary group topic

Next Topic:  2.2.3 Topic domains: Technical content

Parent Topic:  2.2.2 Technical content: Document and information types

Sibling Topics:

2.2.2.8 Concept topic

2.2.2.9 Reference topic

2.2.2.10 General task topic

2.2.2.11 Task topic (strict task)

Machinery Task topic

2.2.2.13 Glossary entry topic

2.2.2.14 Glossary group topic