Page Layout Elements
Introduction
The page layout options specify:
- The <pagebox> is a set of page boundaries that AppendPDF Pro uses when stamping and placing information.
- Header and footer height is measured from the top and bottom margins within the <pagebox>.
- The left and right margins within the <pagebox>.
- The page column width is the width of the column that holds the page numbers.
See the following table for detailed information on the structure of the <TOC> layout.
Contents of the <TOC> Page Layout Element
Element | Level | Pro | Required | Content |
---|---|---|---|---|
<appendparam version=”1.0″> | Top | ✔ | Topmost element, contains entire parameter spec | |
⇔ <toc> | 2 | Pro | Table of contents information | |
⇔ <pagebox> | 3 | Pro | Specifies page box | |
OR <artbox> | 4 | Pro | Empty: page box is art box | |
OR <bleedbox> | 4 | Pro | Empty: page box is bleed box | |
OR <cropbox> | 4 | Pro | Empty: page box is crop box [default] | |
OR <mediabox> | 4 | Pro | Empty: page box is media box | |
OR <trimbox> | 4 | Pro | Empty: page box is trim box | |
<headerheight> | 3 | Pro | Text: Specifies header height* [72 pt] | |
<footerheight> | 3 | Pro | Text: Specifies footer height* [72 pt] | |
<leftmargin> | 3 | Pro | Text: Specifies left margin* [72 pt] | |
<rightmargin> | 3 | Pro | Text: Specifies right margin* [72 pt] | |
<pagecolumnwidth> | 3 | Pro | Text: Specifies page column width* [72 pt] |
* Refer to the Table of Contents: Page layout options explained illustration below for more explanation of these measurements.
XML Code Sample
<appendparam version="1.0"> <!-- . Indicates skipped sections --> <!-- . --> <TOC> <!-- . --> <!-- . --> <pagebox> <!-- Choose only one of the 5 options --> <artbox /> <bleedbox /> <cropbox /> <mediabox /> <trimbox /> <!-- End of options --> </pagebox> <headerheight>84</headerheight> <footerheight>60</footerheight> <rightmargin>72</rightmargin> <leftmargin>72</leftmargin> <pagecolumnwidth>60</pagecolumnwidth> <!-- . --> <!-- . --> </TOC> <!-- . --> <!-- . --> </appendparam>
Table of Contents: Page layout options explained
Elements for <TOC> page layout
pagebox
Specifies the boundaries that AppendPDF Pro measures from to determine where to place TOC elements.
artbox
Empty element that tells AppendPDF Pro to use the art box as the page box. The art box defines the extent of the page’s meaningful content as intended by the page’s creator.
bleedbox
Empty element that tells AppendPDF Pro to use the bleed box as the page box. The bleed box defines the region where the contents of the page should be clipped when creating output in a production environment. This may include any extra “bleed area” needed to accommodate the physical limitations of cutting, folding, and trimming equipment.
cropbox
Empty element that tells AppendPDF Pro to use the crop box as the page box. The crop box defines the region to which the contents of the page are to be clipped (cropped) when displayed or printed.
mediabox
Empty element that tells AppendPDF Pro to use the media box as the page box. The media box defines the maximum imageable area of the physical medium on which the page is to be printed.
trimbox
Empty element that tells AppendPDF Pro to use the trim box as the page box. The trim box defines the intended dimensions of the finished page after trimming.
Usage notes for <pagebox>
The default is <cropbox>, which will be appropriate for most applications. If the PDF has a crop box set, this will ensure that none of the TOC information you specify will fall outside the viewable area. The most common exception to this is to specify <mediabox>. The other options may be applicable if you have a complex publishing process.
headerheight
Specifies the distance, in points, from the top of the page box to the start of the Table of Contents entries. Default is 72 points (1 inch).
Specifies the distance, in points, from the bottom of the page box to the end of the Table of Contents entries. Default is 72 points (1 inch).
leftmargin
Specifies the left margin, in points. Default is 72 points (1 inch).
rightmargin
Specifies the right margin, in points. Default is 72 points (1 inch).
pagecolumnwidth
Specifies the width of the column that holds the TOC page numbers. Default is 72 points (1 inch). You can use <pagecolumnwidth> to tighten or loosen up the space between the page numbers and the leader. See leader for more information.
Example
Refer to Table of Contents: Page layout options explained above, for an illustration example of the page layout options.
To specify some common settings:
- Default page box.
- One-quarter inch left and right margins.
- 1.4 inch header to leave room for company logo.
- 3 1/3 inch footer to leave room to stamp company address.
- Approximately one-half inch page column width to hold up to 3 digits.
Insert the following code:
<TOC> <!-- . Indicates skipped sections --> <!-- . --> <!-- . --> <headerheight> 100 </headerheight> <footerheight> 240 </footerheight> <leftmargin> 18 </leftmargin> <rightmargin> 18 </rightmargin> <pagecolumnwidth> 40 </pagecolumnwidth> <!-- . --> <!-- . --> <!-- . --> </TOC>