This chapter lists the sequence of pages that comprise a book’s front matter. Numbered pages in the front matter use roman numerals i, ii, iii… An author can test different settings by pressing the PDF options button on the book’s trail page. To use a form to edit the descriptive metadata used in the front matter, such as a blurb or halftitle page logo, add the following directive to the trail page:
On this page… (hide)
The optional publisher’s blurb consists of a short paragraph about the author or the work (optional), followed by a series of quotes praising the genius of the author and the brilliance of the work. To include a blurb page or pages, add the following to the book’s trail page (the about is optional):
(:blurb:) (:about: Suspendisse at fringilla libero. Aenean venenatis nibh... :)
Wikipublisher will look for a page in the current group called PublisherBlurb and print the about paragraph if present, followed by “Praise for Title of Book”, followed by the contents of the blurb page. Alternatively, the author can use the following variant to change the blurb page used, use a phrase other than “Praise for”, or both:
(:blurb: Testimonials "Readers Love" :)
Authors can lay out a series of short reviews using the quotation markup. This is illustrated in Sample publisher blurb text, from the blurb for the New Zealand edition of Wolf Hall by Hilary Mantel. Note the use of emphasis markup within the attribution to turn emphasis off.
The halftitle page prints a logo (optional), the title (the title of the book’s trail page), and the date (defaults to the date and time of printing). The page layout is controlled using metadata settings on the book’s trail page.
The author can specify a logo (an image) using wiki page text variable markup
If the author specifies image alt text, using the "alt text" markup, the logo is treated as a “frontispiece” and prints on the verso page facing the title page.
The author can modify the title using the
An administrator can modify the date format by redefining $CurrentTimeFmt in local/config.php, before loading the Wikipublisher extensions. An administrator can define a specific date and time (or no date) by redefining $CurrentTime in local/config.php, before loading the Wikipublisher extensions. For example, to print the current month and year set:
$CurrentTimeFmt = '%B %Y';
By convention, the halftitle verso page lists other works by the author, or other works in the series of which the current work is part. If Wikipublisher finds a page called $Group.BookHalftitleVerso or Site.BookHalftitleVerso, it prints the contents on the halftitle verso page; otherwise, the page is blank. $Group is the name of the group in which the book’s trail page is defined.
The cover metadata argument controls the alignment of text on the page. One widely-used convention is to set the author name in small caps and set titles in italics and indented. This is illustrated in Sample halftitle verso page.
The title page prints the book’s title, subtitle, author and publisher. The author can modify the default title, subtitle and author settings by using the
By default, the publisher field is empty. The author can set the publisher field by using the
(:description Publisher Name:)
The title verso page prints publishing information and a legal notice. This consists of:
Title verso page layout describes how an author can control the title verso page layout by setting options on the book’s trail page. The ISBN must be enclosed in [=…=] markup to prevent automatic “smartening” of the hyphens.
An administrator can redefine $WPTypeset, $WPLocation and
A dedication is optional. If present, the dedication alignment matches that of the halftitle and title pages. The author can specify a dedication using a page text variable on the book’s trail page:
(:dedication: This book is dedicated to my goldfish:)
An epigraph (also known as an inspiration page) is optional. The author can specify an epigraph using a page text variable on the book’s trail page (attribution — author name and title of source — is optional):
(:epigraph: The quote text -- Author Name "Title of Source" :)
Wikipublisher generates and prints a book table of contents automatically. Contents page options lists the additional kinds of contents pages, which can be produced by adding arguments to the (:typeset-book:) directive on the trail page.
If the Main Matter specifies a preface chapter, Wikipublisher prints this before (the default) or after (using