From the WikiPublisher

Tip of the Week: 00017

Metadata: Options for adjusting the print layout

How much control do I have over how Wikipublisher lays out the printed page?

Gutenberg checks the print quality

Wikipublisher uses the Wikibook meta element to pass layout control instructions to the typesetting engine. Each instance of the meta element is a type/value attribute pair and Wikipublisher includes pre-set default values for each class of document. Let’s look first at the kinds of control available, then at how to change the default settings.

Defining print metadata gives authors and readers a great deal of flexibility. Most meta element settings are generic — they have the same meaning in all document classes (e.g. whether to use a sans or serif font for headings). All classes lists these.

Generic metadata settings
bodystylebody text can print in a sans or serif font
colorlinkstext of hyperlinks can be displayed in colour
duplexlay out pages for two- or one-sided printing
floathereallow floating images and tables to print “here”
fontsetchoose a fontset for heading (sans) and body (serif) text
headingstyleheading text can print in a sans or serif font
imagesizechoose how to print images for optimum quality
justificationbody text can be set justified or ragged right
pagesizepaper can be A4, A5 or US letter
parasepparagraphs can be separated by space or by indenting
watermarka watermark can be printed on every page

However, some metadata settings are class-specific and apply only to certain classes of document (e.g. what chapter style to use for a book). Selected classes lists these.

Class-specific metadata settings
autonumberwhether (and how deeply) to number sectionsreport, article
chapterstylestyle used for chapter headingsbook
coveralignment of front cover textreport
coverstylecover text can print is sans or serif fontreport
figurelistgenerate a list of figuresreport, book
returninclude the sender’s return address in the footerletter
sectionnewpagestart major sections on a new recto pagereport, article
tablelistgenerate a list of tablesreport, book
textsizeprint text in a regular or large fontsizearticle, letter
tocgenerate a table of contentsarticle

A reader can change the default settings by pressing a PDF options button. This will display a form showing the current settings, which can then be modified as the reader sees fit. Any revisions apply to the current print request only; subsequent printings revert to the default metadata values.

An author can add metadata type/value pairs to any (:typeset:) directive. Any such settings are locked into place — a reader cannot adjust them in the corresponding options form. For example, an author setting up a trail page for typesetting might write the following:

    (:typeset cover=left sectionnewpage=on imagesize=sidecaps:)

Site-wide default values are defined on template pages in the Site group: Book Template, Calendar Template, Include Template, Letter Template, Print Template, Publish Template, Search Template. An administrator can edit these to change the default settings for the entire site. An administrator can also change the defaults for a particular group, by creating one or more template pages within the group.

For example, to set local defaults for typesetting individual pages in the current group:

That’s all. The local group settings will take precedence over the site-wide settings. If you wish to change one of the generic settings, for example to make US letter the default paper size for all printed output, you have to change this in all templates. This group has a local Search Template.

Category: metadata

Copyright © 2005–2024 the Wikipublisher wiki and its authors

Retrieved from

Page last modified on 21 February 2008 at 07:58 PM