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.
Have a look at the metadata settings for this page. Click the PDF icon, then press the “View XML” button. Note the list of <meta> elements.
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.
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.
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.