From the WikiPublisher

Book Guide: Shape Shifting

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)

  1.   1.  Title page styles
  2.   2.  Chapter styles
  3.   3.  Body styles
  4.   4.  Presentation styles
  5.   5.  Horizontal rule styles
  6.   6.  Floating object styles

1.  Title page styles

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.

TypePossible valuesDefault value
pagesizeA4, A5, US, HU, TPA4
coverleft, centre, rightleft
coverstylesans, serifsans
halftitleon, count, offon
titlepageregular, fancy, fancier, fanciestregular

2.  Chapter styles

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.

TypePossible valuesDefault value
chapterstylePlain, Robyn, Sonny, Lenny, Glenn, Conny, Rejne, Bjarne, Bjornstrup, Alison, Christa, Gustav, Kate, RobertPlain
headingstylesans, serifsans
headingcolorNone, Bittersweet, BlueViolet, BrickRed, DarkOrchid, ForestGreen, MidnightBlue, NavyBlue, OliveGreen, PineGreen, RawSienna, RedOrange, RoyalBlue, RoyalPurple, Sepia, WildStrawberryNone
autonumber0, 1, 2, 32
ucsectionon, offoff

3.  Body styles

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.

TypePossible valuesDefault value
parasepindent, spaceindent
justificationon, offon
hrrepeaton, offoff
bodystylesans, serifserif
fontsetpslatex, timex, default, newcent, palatino, palatcm, fourier, keplerpslatex
fontsize10pt, 11pt, 12pt11pt
spacesingle, onehalf, double, frenchsingle

4.  Presentation styles

Presentation style options describes the controls for the sequencing and presentation of various output elements.

TypePossible valuesDefault valueMeaning
prefaceon, offonPreface before (on) or after (off) contents pages
chapterbibon, offoffBibliography for each chapter (on) or at the end (off)
chappgon, offoffPage numbers by chapter (on) or continuous (off)
tocon, offoffContents for each chapter (on) or in front matter only (off)
colorlinkson, offoffColor-code link text (on) or all black links (off)
urlstyleon, offonTypewriter font for url (on) or bodystyle (off)

5.  Horizontal rule styles

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.

105clover cross (default)
150sparkle cross
166diamond cross
121bold asterisk
122open asterisk
133petal asterisk
134open petal asterisk
140five petal flower
246aldus leaf
247hedera leaf
squareopen square

6.  Floating object styles

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.

TypePossible valuesDefault value
imagesizeregular, small, sidecaps, rotateregular
floatherefigures, tables, cfloats, on, offoff
cfloatstyleboxed, ruled, plain, plaintopplaintop
cfloatcols1, 2, 31

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");



1 Choosing french spacing suppresses the extra space normally added after a full stop. (↑)

Copyright © 2005–2022 the Wikipublisher wiki and its authors

Retrieved from

Page last modified on 21 November 2016 at 02:48 PM