<front-matter>

Description

A front-matter metadata entry specifying front matter to be included in the book.

PDF

The referenced BDML document must contain a single chapter containing the front-matter content.

The order of front matter entries (including the optional automatically generated table of contents) is determined by the order of the <front-matter> and <toc> metadata entries.

Attributes

Attribute name Description
url The url to the front matter document.
target Apply this metadata element only to the specified targets. See BDML schema for more information on metadata elements.
variant Apply this metadata element only when the variant is specified during translation. See BDML schema for more information on metadata elements.

Immediate descendants

No element descendants are defined for the <front-matter> element.

Immediate ancestors

Element name Relation
<metadata> The enclosing metadata element.

Example

Given the following BDML file:

<document xmlns="http://boradoc.org/1.0">
  <metadata>
    <front-matter url="preface.bdml" />
  </metadata>
  <chapter>
    <para>Main body.</para>
  </chapter>
</document>

where preface.bdml contains the following: 

<document xmlns="http://boradoc.org/1.0">
  <chapter>
    <para>Thanks to ABC Corp</para>
  </chapter>
</document>

The first BDML file renders to the following:

Thanks to ABC Corp

Main body.