Recent Changes · Search:

Support the Project



edit SideBar


Book: Publish a page collection with the Wikipublisher Book class

How do I publish a properly formatted book, spanning multiple wiki pages?

A 15th century printing press

The (:typeset-book:) directive turns a trail into a book. The differences between a book and a report are:

  • a book includes a cover page before the title page
  • a book is divided into chapters, each of which starts on a new page, whereas a report is divided into sections
  • a book may include unnumbered material before the table of contents, such as a preface or acknowledgments
  • a book may include one or more numbered appendices
  • a report may include the trail page text before the contents, whereas books always omit the trail page

The book template has 7 pre-defined chapter styles, from the plain to the fancy. A chapter can also include an optional aphorism, printed in the white space above and to the right of the chapter heading. Wikipublisher identifies aphorism text by re-interpreting the :term:definition line markup. Here is an example for chapters called “Innovation” and “Planning”. The term is the chapter heading and must be a link to a wiki page;1 the definition is the aphorism text. The second aphorism in attributed.

  :[[Innovation]]:Innovation never happens as planned.

  :[[Planning]]:Our plans were perfect, it's just our 
  assumptions were wrong. -- Ken Olsen

Wikipublisher treats the following special chapter names as unnumbered elements: Preface, Introduction, Acknowledgments, and Colophon.2 The corresponding wiki pages may be called by other names, in which case the author can use link text to re-define the page name. For example: [[Background | Introduction]] maps the page named “Background” to become the book’s “Introduction”. The Preface prints before the table of contents; other special chapter names print in the order listed in the trail.

For wikis in languages other than English, an administrator can define an array called $ChapterKindFmt to provide translations for the unnumbered chapter types. Authors can then use the local language names in their chapter link texts. For example, an administrator may prefer to define:

   $ChapterKindFmt[2] = 'Acknowledgements';

If the link text of a first level list item starts with Appendix, that item and any subsequent items are treated as appendices and numbered Appendix A, B, …

Finally, if the book trail page contains a (:description:) directive, the contents are printed on the book’s title page.


1 The wiki page may or may not exist. (↑)

2 Version 2.1.11 adds Prologue and Epilogue. (↑)

Category: document type

« 00014 · Edit Form · 00016 »

Creative Commons License
Edit · History · Print · Recent Changes · Search · Links
Page last modified on 21 February 2008 at 07:53 PM