Recent Changes
Recent Changes · Search:

The main matter consists of the collection of wiki pages that are assembled and presented to form the book’s contents.

On this page… (hide)

  1.   1.  Scope
  2.   2.  Structure
  3.   3.  Chapter markup
  4.   4.  Multi-part books
  5.   5.  Table of contents text
  6.   6.  Wiki page footers

1.  Scope

The main matter contains all the chapters that make up the book. This covers:

  • opening matter (optional)
    • Preface (printed as part of the Front Matter)
    • Foreword
    • Acknowledgments
    • Introduction
    • Prologue
  • body matter
    • Parts (optional)
    • Chapters
  • closing matter (optional)
    • Afterword (printed as part of the Back Matter)
    • Epilogue
    • Colophon
    • Appendices

2.  Structure

Apart from the preface and afterword, Wikipublisher prints chapters in the order they are listed on the trail page. Sample trail page illustrates a simple book trail.

Sample trail page

* [[Preface]]

* [[Sample Chapter]]

* [[Another Chapter]]

* [[Afterword]]

* [[Sample Appendix |Appendix: Sample Appendix]]

* [[Another Appendix]]


3.  Chapter markup

Book chapters are either numbered or unnumbered, depending on the chapter markup used. Chapters are numberd by default; numbering can be suppressed using one of the unnumbered chapter keywords. Wikipublisher recognises the following chapter link markup:

  • [[Chapter Title]] or [[Page Name |Chapter Title]], for a regular numbered chapter
  • [[Keyword]], where Keyword is one of Preface, Foreword, Acknowledgments, Introduction, Prologue, Afterword, Epilogue, or Colophon
  • [[Page Name |Keyword: Chapter Title]], where Keyword is one of the above keywords
  • [[Page Name |Number: Keyword]], to number an otherwise unnumbered chapter
  • [[Page Name |unNumber: Chapter Title]], to suppress numbering of an otherwise numbered chapter1
  • [[Page Name |Appendix: Appendix Title]], to designate the start of the appendices

4.  Multi-part books

Books can be divided into numbered or unnumbered parts using heading markup and the Part or unPart2 keywords. Sample multi-part trail page illustrates a multi-part book trail. It uses an unnumbered part to insert a cover page before the appendix. This also makes the book’s table of contents page a more accurate representation of the book’s structure.

Sample multi-part trail page

* [[Foreword]]

!! Part: The First Part

* [[Sample Chapter]]

* [[Another Chapter]]

!! Part: The Second Part

* [[Third Chapter]]

* [[Fourth Chapter]]

!! unPart: Appendices

* [[Sample Appendix |Appendix: Sample Appendix]]

* [[Another Appendix]]


5.  Table of contents text

By default, Wikipublisher uses the part and chapter heading text for entries in the table of contents and PDF bookmarks. Sometimes, an author wishes to do something different; maybe the part name contains a break to produce a particular layout, or perhaps the chapter title is very long. The author can do this by specifying the text for the contents entry in quote marks after the normal text. For example:

!! Part: Four Seasons[[<<]]in[[<<]]One Day "Four Seasons in One Day"

6.  Wiki page footers

For each wiki page processed, Wikipublisher appends the text of a “footer page” if it exists, by looking for a page called $Group.GroupPublishFooter. For example, an author may wish to prepare a shared bibliography on a page called ListOfReferences and use this in each chapter of the book. The author can do this by setting up a GroupPublishFooter page containing the following markup:

(:bib page=ListOfReferences:)


Inclusion of the footer can be suppressed by using the (:nogroupfooter:) directive.


Front Matter | Book Guide | Back Matter


1 Wikipublisher also recognises Unnumber and UnNumber as keywords for an unnumbered chapter (↑)

2 Wikipublisher also recognises Unpart and UnPart as keywords for an unnumbered part (↑)

Page last modified on 05 September 2010 at 09:56 AM