Next / Previous / Contents / Shipman's homepage

4.8. simpleMaster(): The simple-page-master

Each call to this function generates the XML subtree that defines a simple-page-master element. The resulting subtree is added to the .masters attribute of the FlowTree instance. The function prototype:

simpleMaster(masterName, pageDim, *contents, **attrs)

Name of the master you are defining; this becomes the master-name attribute.


A PageDim instance describing the desired page size (from pageDim.pageBox) and the page's outer margins (from pageDim.pageMargins).

The masterName argument is the name of the master you are defining. It becomes the master-name attribute. The positional arguments in contents and the keyword arguments in attrs are added to the simple-page-master node, using the convention described in Section 4.2, “The E(*contents, **attrs) convention”.

In general, to supply the attributes of the simple-page-master node you are building, use keyword arguments, or supply dictionaries as positional arguments.

The nodes you supply as positional arguments will be nodes defining the dimensions of the five standard parts of the page. These must be supplied in a fixed order; see these helper functions, in order: