# Bookmap Readme

This demonstration provides a proof-of-concept implementation of the DITA bookmap proposal. The proposal adds book output to DITA using a specialized DITA map known as a bookmap. The bookmap organizes the DITA topics with the correct nesting and sequence for the book. In addition, the bookmap assigns roles such as preface, chapter, and appendix to top-level topics within the book.

For more detailed information about the proposal, see the detailed posting on the DITA forum at news://news.software.ibm.com:119/c11fd3$85qq$2@news.boulder.ibm.com.

Note: This demonstration has the following limitations:

- For XSL-FO formatting and thus PDF generation, only the basics have been implemented. Through specialization, the DITA XHTML-based outputs for DITA map are also available for bookmap.
- The design for the book info component of the proposal has been fleshed out based on antecedents in DocBook and IBMIDDoc (see the comments in the `bookinfo.mod` file). Most of the elements in bookinfo aren't processed.
- The book list component of the proposal hasn't been implemented yet. Designs for a glossary list have been discussed extensively on the DITA forum (see the summary posted as news://news.software.ibm.com:119/blfg38$5k0q$1@news.boulder.ibm.com).
- The book style component of the proposal is much more experimental than the bookmap and bookinfo components. Processing for this component is limited.