Front Matter and Back Matter
Edit online

The front matter is a series of topics that are usually placed after the cover page and before the TOC or the content.

The back matter is a series of topics that are usually placed after the content of the book.

Front Matter and Back Matter - Input XML fragment
Edit online

The frontmatter topics are wrapped in an <oxy:front-matter> element, that has the class bookmap/frontmatter (it is a clone of the original <frontmatter> element from the map):

<bookmap xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" ...>
    <oxy:front-page xmlns:oxy="http://www.oxygenxml.com/extensions/author" 
                    class=" front-page/front-page ">
       ...
    </oxy:front-page>
    <oxy:front-matter xmlns:oxy="http://www.oxygenxml.com/extensions/author" 
                  class="- map/topicref bookmap/frontmatter ">
        <concept xmlns:dita-ot="http://dita-ot.sourceforge.net/ns/201007/dita-ot" 
                  class="- topic/topic concept/concept "
            id="unique_1" oid="concept-1">
          ...
    </oxy:front-matter>

For the DITA Map PDF - based on HTML5 & CSS transformation type, the merged map is further processed resulting in a collection of HTML5 <div> elements. These elements preserve the original DITA @class attribute values and add a new value derived from the DITA element name.

<div xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" ...>
    <div class=" front-page/front-page front-page">
       ...
    </div>
    <div class="- map/topicref bookmap/frontmatter frontmatter">
        <div class="- topic/topic concept/concept " id="unique_1" oid="concept-1">
        ...
    </div>

Front Matter and Back Matter - Built-in CSS
Edit online

The built-in CSS rules are in [PLUGIN_DIR]/css/print/p-bookmap-frontmatter-backmatter.css. By default, it associates the <oxy:front-matter> and <oxy:back-matter> elements (or for the DITA Map PDF - based on HTML5 & CSS transformation type, the corresponding HTML div elements with the matter page), that have no headers or other page margin boxes. Each of the child topics start on a new page.

The content of this file is:

@media print {
    *[class ~= "bookmap/frontmatter"],
    *[class ~= "bookmap/backmatter"] {
        page: matter-page;
    }
    
    /* Put the sections on a separate page. */
    *[class ~= "bookmap/frontmatter"] > *[class ~= "topic/topic"], 
    *[class ~= "bookmap/backmatter"] > *[class ~= "topic/topic"]{
      page-break-before: always;
    }
}
Note: This is listed solely for illustration purposes, as the plugin might use something different.

How to Remove Page Breaks Between Front Matter Child Topics
Edit online

If you do not like the fact that all the topics that enter a bookmap frontmatter start on a new page, you can disable this by using the following rules in your customization CSS:
*[class ~= "bookmap/frontmatter"] > *[class ~= "topic/topic"], 
*[class ~= "bookmap/backmatter"] > *[class ~= "topic/topic"]{
      page-break-before: auto;
}

How to Style the Front Matter and Back Matter Topics
Edit online

Suppose you want the topics from the front matter and back matter to start at the middle of the page and use a smaller fine print.

In your customization CSS, add the following:

*[class ~= "bookmap/frontmatter"] > *[class ~= "topic/topic"],
*[class ~= "bookmap/backmatter"] > *[class ~= "topic/topic"] {
    margin-top: 50%;
    border-top: 5pt solid silver;
    font-size: 0.5em;
}