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

Page layout options detailed

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).

footerheight

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>