Syntax #
p.title.toc-part
Purpose #
The p.title.toc-part annotation is used to tag an element as being the start of a larger grouping of content within a book’s structure. A part element exists in the bookmap’s metadata and contains one or more chapters. This allows chapters to be divided into related groups within the bookmap’s structure.
This annotation should be applied to the heading of the section where you wish to begin a part. It will contain all following content until the next part, appendix, or backmatter element is created. This annotation overrides a chapter element, and so should be applied before an annotation that creates a chapter element.
This annotation is not applied to the table of contents entry.
Examples #
The following is an example of a time when you might want to use the annotation:
The following is an example of a rule that will apply the annotation
The following is an example of the DITA output you would get from the annotation.
<part>
<chapter>
<topicref href=”Chapter_1_Overview_of_the_MacGuffin.dita”>
<topicref href=”The_MacGuffin.dita”/>
<topicref href=”Usage_Scenarios.dita”/>
</topicref>
</chapter>
<chapter>
<topicref href=”Chapter_2_Assembly_of_the_MacGuffin.dita”>
<topicref href=”Assembling_the_MacGuffin.dita”>
<topicref href=”To_assemble_the_MacGuffin.dita”/>
<topicref href=”To_Calibrate_the_MacGuffin.dita”/>
</topicref>
<topicref href=”Preparing_the_MacGuffin_for_Use.dita”>
<topicref href=”To_Orient_the_MacGuffin.dita”/>
<topicref href=”To_Align_the_MacGuffin_Lenses.dita”/>
</topicref>
</topicref>
</chapter>
</part>
<part>
<chapter>
<topicref href=”Chapter_3_Operation_of_the_MacGuffin.dita”>
<topicref href=”Starting_the_MacGuffin.dita”>
<topicref href=”To_Start_the_MacGuffin.dita”/>
</topicref>
<topicref href=”Rotating_the_MacGuffin.dita”>
<topicref href=”To_Rorate_the_MacGuffin.dita”/>
</topicref>
<topicref href=”Stopping_the_MacGuffin.dita”>
<topicref href=”To_Stop_the_MacGuffin.dita”/>
</topicref>
</topicref>
</chapter>
</part>
