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:
  • Referencing a DITA map
  • Referencing a DITA topic
  • Nesting <topicref> elements
<bookmap id="taskbook">
    <mainbooktitle>Product tasks</mainbooktitle>
    <booktitlealt>Tasks and what they do</booktitlealt>
    <author>John Doe</author>
        <person href="task_preface.dita>Jane Doe</person>
  <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"/>
  <appendix href="task_appendix.dita"/>


The following DITA modules are provided for the bookmap specialization.

Return to main page.

OASIS DITA Version 1.2 -- OASIS Standard, 1 December 2010
Copyright © OASIS Open 2005, 2010. All Rights Reserved.