A single <frontmatter> element can be placed early in your <book> or <article>, after some metadata, such as the overall <title>. It is optional, but likely highly desirable. The following subsections describe the items that may be employed within the <frontmatter>. Most are optional, and some may be repeated. An <article> differs in that it must contain a <bibinfo> and <titlepage> and then may only contain an <abstract>. Generally, these will get default titles, localized in the language of your document, but these defaults may also be replaced by giving a <title> element. None of these divisions themselves is numbered, precluding any content within that is numbered. So, for example, no <figure> may be included. But you could choose to include an <image>, perhaps within a <biography>.
If a component of the front matter cannot be numbered, how best to subdivide something like a <preface>? This is a good use of the <paragraphs> element. It allows for a (minimal) title, but cannot be subdivided further. See the later part of Section 4.6 for more about this exceptional element.
These elements must appear in your source in the order given below, and will appear in your ouput in the same order, which is a generally accepted order used in the production of books. So, for example, even if you author an <acknowledgement> between two <preface>, your output may (will?) place the Acknowledgement before the first Preface.
(We have not yet described the contents of these various elements in full detail.)
Subsection4.25.1Bibliographic Information
Required. The <bibinfo> element may contain metadata about your document, including <author>, <editor>, <credit>, <date>, <edition>, <website> and <copyright>. Additional elements to capture bibliogrphic information are planned.
Subsection4.25.2Title Page
Optional. When present, the <titlepage> should contain a single empty element <titlepage-items/>, that will collect the appropriate elements from <bibinfo> to generate a titlepage.
Subsection4.25.3(*) Abstract
Optional, and only available for an <article>.
Subsection4.25.4Colophon
Optional; only available within a <book>. The front colophon. (There is also a back colophon, see Subsection 4.26.6). Sometimes this is also called the copyright page. The <colophon> element can be given a @label to produce a specific file name in HTML builds. The only allowable (and required) child of the <colophon> is the empty element <colophon-items/>, which will automatically bring in appropriate elements from <bibinfo>.
Subsection4.25.5(*) Biographies
Multiple <biography> elements, one per author.
Subsection4.25.6(*) Dedication
A single <dedication> element, that might include multiple dedications (perhaps by different authors).
Subsection4.25.7(*) Acknowledgements
A single <acknowledgement> element (note spelling), that becomes a division, and so can contain paragraphs, lists, etc. The Chicago Manual of Style [1, 1.52] suggests that if these are short, they may be contained in a preface.
Subsection4.25.8(*) Forewords
As of 2021-07-16 the <foreword> element is not fully implemented. Please make a feature request if you need it.
A <foreword> is written by somebody other than the author. The name of the writer of the foreword need to be included—at the end is a good location.
Subsection4.25.9(*) Prefaces
Multiple prefaces are a distinct possibility, and in this case providing a different <title> for each would be essential. Examples might include: “Preface to the Third Edition”, “How to Use this Book”, or “To the Student”. More ad-hoc material, such as a translator’s note, can be handled as a preface.
Best Practice4.25.1.Understand the Role of a Preface.
Chicago Manual of Style[1, 1.49] begins with “Material normally contained in an author’s preface includes reasons for undertaking the work, method of research, …” Note that a preface is not introductory content and is not an introduction. It is written from the author’s point-of-view, and may include information about why they are qualified to write on the topic of the book. If there are several editions, the prefaces to the newer editions are placed first. See the related Best Practice 26.3.1.
