The Book application is essentially
identical to the Topic application except that it has three additional
elements that are used to isolate the separate pieces that are part of
the book. The Book application also makes use of special fm-tabletitle and fm-figuretitle elements
for proper table formatting.
- fm-ditabook
- The
root element of the generated book file. Also represents the root
DITA map used to create the book. The href attribute defines the
path and name of the source ditamap file. Additional attributes
may be added from map metadata for use as variables or by element
definition context rules.
- fm-ditafile
- Identifies
each DITA topic file. The href attribute defines the path and name
of the source topic file. The maptype attribute contains the name
of the element that referenced this topic file in the original ditamap.
This is used by the book-build process to identify specific book
components to automatically apply templates as well as numbering
and pagination properties.
- fm-bookcomponent
- Used
as a container for generated book components. This wraps any generated that
are added by the book-build process, or you can add this for any
generated files you add manually.
- fm-tabletitle
- Allows
for properly formatted table titles in generated FrameMaker files.
The Book application must have the fm-tabletitle element defined
and valid as a child of the tgroup element.
- fm-figuretitle
- Supports fm-xref references
to “moved” figure titles in generated FrameMaker files. The Book
application must have the fm-figuretitle element defined
and valid as the last child of the fig element. If this element
is not defined, the “move figure titles” book-build option will
use the default title element, but in order to support cross-references
to figure titles that are moved, this element must be defined and
have its @id attribute’s type set to “UniqueID.”
Other than these special “fm-*” elements that are unique to the
Book application, three element definitions vary from those in the
Topic application:
- title
- The context rule level numbering differs to allow for an additional
level of “chapter titles.”
- fig
- Includes the title and fm-figuretitle elements as optional
elements at the end of the general rule. This is required by the
“Move fig/title to end of fig element” Book Build option.
- tgroup
- Includes the fm-tabletitle element
in the general rule. This is required by the “Move table/title to
table/tgroup/title” Book Build option.