2. The <bookmap> element
A 
element is just a
more elaborate form of . We recommend using a
<bookmap> element is just a
more elaborate form of <map> . We recommend using a
<bookmap> for anything more complex than an
article. |
TipYou don't need to create a
<map> for the screen media and a
<bookmap> for the print media. If you follow the
“one topic per XML file” rule, a single topic map
(<map> or <bookmap>
depending on the complexity of the contents) is all you need. |
- A
<bookmap>may have a<booktitle> rather than a
<title>. - Its metadata wrapper element,
<bookmeta>, may contain
richer information than the <topicmeta> element. - A bookmap may contain specializations of the
<topicref> element having
stronger semantics: <part>, <chapter>, <appendix>. - The hierarchy of references to topic elements which makes up the
body of the document may be preceded by a
<frontmatter> element and
followed by a <backmatter>
element.
These wrapper elements can contain references to actual, hand-written, topics: bookabstract, <preface>, <dedication>, <colophon>,
etc.However the most common use of<frontmatter>and<backmatter>is to contain the following, empty placeholder elements:<toc>, <figurelist>, <tablelist>, <indexlist>. These
placeholders instructs the DITA processing software to automatically
generate: a Table of Contents, a List of Figures, a List of Tables, an
Index.
What follows is a possible ):
<bookmap> for this
tutorial (contents of file tutorial-book.ditamap ):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
<bookmap> <booktitle> <mainbooktitle>DITA for the Impatient</mainbooktitle> </booktitle> <bookmeta> <authorinformation> <personinfo>...</personinfo> <organizationinfo>...</organizationinfo> </authorinformation> <critdates> <created date="October 7, 2009"/> </critdates> </bookmeta> <frontmatter> <booklists> <toc/> <figurelist/> <tablelist/> </booklists> </frontmatter> <chapter href="introduction.dita"/> <chapter href="topics_and_maps.dita"/> <chapter href="topic.dita"> <topicref href="topic_structure.dita"> <topicref href="samples/sample_topic.dita" toc="no"/> </topicref> <topicref href="block_elements.dita"/> <topicref href="inline_elements.dita"/> <topicref href="link_elements.dita"/> </chapter> . . . <chapter navtitle="Topic maps"> <topicref href="map.dita"/> <topicref href="bookmap.dita"/> </chapter> <chapter href="conclusion.dita"/> </bookmap> |