footers

The footers function gives the script developer the ability to specify the footers for the current section of the document.

 @(footers (first; odd; even))

The result of the function footers is of type TEXT. This function has three parameters:

  1. first, type TEXT. This is the content for the footer on the first page. The content depends on the specific word processor you use to develop a Master Template.
  2. odd, type TEXT. This is the content for the footers on odd numbered pages. The content depends on the specific word processor you use to develop a Master Template
  3. even, type TEXT. This is the content for the footers on even numbered pages. The content depends on the specific word processor you use to develop a Master Template.

The result of the function footers is of type TEXT. The output of this function has effect at the location where it is put into the result document.

This function has no effect on the AiaDocXML and HTML output.

If the result of multiple calls to the function footers is put in the same section, only the last result has impact on the section.

An example is provided here.

# BEGIN 
#
@(footers ("First page footer"; ""; "Even page footer containing two lines of text.")
#
END #

The option "Different first page" in the Microsoft Word GUI controls whether the first page footer is shown on the first page. If this option is disabled in a section, the first page footer is not shown, even though it is present in the result document.

The option "Different odd and even" in the Microsoft Word GUI applies to the complete document and is controlled by the setting from the Template script. It can be changed with the pagestyle function (see pagestyle) or the pragma function (see pragma).

All footers must end with a paragraph break. As Microsoft Word accepts footers that do not end with a paragraph break, the behavior is undefined.

You can disable a footer by specifying an empty string for that footer. This takes up the white space around the footers compared to a footer that is empty. This feature is not available in the Microsoft Word GUI.