Using different combinations of print metadata values, it is possible to produce thousands of different book layouts. While all are recognisable as Wikipublisher designs, by experimenting with different settings, authors can choose a design that matches the book’s purpose and style. Settings are controlled through a $Group.BookTemplate page, the PDF options button, or arguments in the (:typeset-book:) directive.
On this page… (hide)
Front cover options describes controls for the look of the pages in the Front Matter. For example, an author may choose HU (5½″ × 8½″) size, right aligned, sans font, count the halftitle as page i, and fancy title pages.
Type | Possible values | Default value |
---|---|---|
pagesize | A4, A5, US, HU, TP | A4 |
cover | left, centre, right | left |
coverstyle | sans, serif | sans |
halftitle | on, count, off | on |
titlepage | regular, fancy, fancier, fanciest | regular |
Chapter style options describes controls for the look of chapters in the Main Matter. For example, an author may choose Robyn, serif headings, coloured RawSienna, and numbered to level 3 (subsubsections) with sections (level 1 headings) in uppercase.
Type | Possible values | Default value |
---|---|---|
chapterstyle | Plain, Robyn, Sonny, Lenny, Glenn, Conny, Rejne, Bjarne, Bjornstrup, Alison, Christa, Gustav, Kate, Robert | Plain |
headingstyle | sans, serif | sans |
headingcolor | None, Bittersweet, BlueViolet, BrickRed, DarkOrchid, ForestGreen, MidnightBlue, NavyBlue, OliveGreen, PineGreen, RawSienna, RedOrange, RoyalBlue, RoyalPurple, Sepia, WildStrawberry | None |
autonumber | 0, 1, 2, 3 | 2 |
ucsection | on, off | off |
Body style options describes controls for the look of chapter body text. For example, an author may choose spaces between paragraphs, justification off, hrrepeat on (3 dingbats in a horizontal rule), serif text, and 10pt palatino with french spacing.1 The fontsize is reduced automatically if the author selects a pagesize of A5 or HU.
Type | Possible values | Default value |
---|---|---|
parasep | indent, space | indent |
justification | on, off | on |
hrrepeat | on, off | off |
bodystyle | sans, serif | serif |
fontset | pslatex, timex, default, newcent, palatino, palatcm, fourier, kepler | pslatex |
fontsize | 10pt, 11pt, 12pt | 11pt |
space | single, onehalf, double, french | single |
Presentation style options describes the controls for the sequencing and presentation of various output elements.
Type | Possible values | Default value | Meaning |
---|---|---|---|
preface | on, off | on | Preface before (on) or after (off) contents pages |
chapterbib | on, off | off | Bibliography for each chapter (on) or at the end (off) |
chappg | on, off | off | Page numbers by chapter (on) or continuous (off) |
toc | on, off | off | Contents for each chapter (on) or in front matter only (off) |
colorlinks | on, off | off | Color-code link text (on) or all black links (off) |
urlstyle | on, off | on | Typewriter font for url (on) or bodystyle (off) |
Authors can control the way Wikipublisher prints horizontal rules, which use a dingbat character (“clover cross”) by default. Horizontal rule style options lists the characters most commonly used for horizontal rule separators. For example, setting hrstyle=144 produces a snowflake. Wikipublisher also supports an “invisible rule” using the space character. Authors can insert an invisible rule by starting a new paragraph with two or more line-breaks (\\\) on a line by themselves.
This paragraph follows an invisible rule. The first line of the paragraph following a horizontal rule is not indented.
Value | Meaning |
---|---|
105 | clover cross (default) |
150 | sparkle cross |
166 | diamond cross |
121 | bold asterisk |
122 | open asterisk |
133 | petal asterisk |
134 | open petal asterisk |
140 | five petal flower |
144 | snowflake |
246 | aldus leaf |
247 | hedera leaf |
040 | space |
asterisk | asterisk |
square | open square |
Floating object style options describes controls for the presentation of floating objects — figures, tables and custom floats. For example, an author may choose to allow wide images to rotate, to float tables “here” if possible, a ruled style for custom floats, with 2 text columns in any custom floats.
Type | Possible values | Default value |
---|---|---|
imagesize | regular, small, sidecaps, rotate | regular |
floathere | figures, tables, cfloats, on, off | off |
cfloatstyle | boxed, ruled, plain, plaintop | plaintop |
cfloatcols | 1, 2, 3 | 1 |
By default, Wikipublisher sets the custom float label to “Excerpt” and produces a “List of Excerpts” in the Front Matter. An author can specify the label given to custom floats by using the cfloat page text variable. For example, to change the label to “Exercise” an author uses the following markup on the book’s trail page:
(:cfloat: Exercise:)
This will automatically generate a “List of Exercises” heading for the contents page. Sometimes, this is not what the author wants. Authors can specify their own preferred heading as follows:
(:cfloat: Exercise "Exercises for the Reader":)
An administrator can set the same custom float label for all books by adding the following line to local/config.php after loading the Wikipublisher extensions (the second argument is optional and may be omitted):
SetCfloatName("Exercise", "Exercises for the Reader");
← Back Matter | Book Guide | Appendix: Technical Matters →
1 Choosing french spacing suppresses the extra space normally added after a full stop. (↑)