Additional PDF files

Metadata values can be used to create additional PDF files from selected pages. This does not affect the creation of the main PDF file, which always contains all of the composed pages.

[Note] Note

The creation of additional PDF files is suppressed when creating a PDF that does not contain all composed pages. This occurs when:

  • the “Changed pages only” option is selected; or

  • a specific range of pages is selected in the Create PDF dialog; or

  • the PDFPMAP API call is used to create a PDF from a specified list of pages.

To create an additional PDF, create a metadata value with the name pdf.output.N where N is “1” for the first file, “2” for the second, and so on. The numbering must be consecutive and start from 1; any break in the sequence will cause subsequent values to be ignored.

Each metadata value has the form PAGES:FILE where PAGES is a comma-separated list of inclusive page ranges and FILE is the path to the PDF file to be created.

Page ranges must use ordinal page numbers (i.e. starting from 1) and consist of either a single number or two numbers separated by ‘-’. If the second number is omitted the range continues to include the final page.

If the file path is relative, it is resolved relative to the folder where the main PDF file is created.

The additional PDF files are created using the same profile as the main PDF file. The only restrictions on additional PDF files are:

  • Links to other pages are suppressed — regardless of whether the page is in the PDF being created. This does not affect links to other targets, such as internet URLs.

  • Bookmarks are disabled.

Example

It is necessary to publish a large book as two volumes. The PDF for both volumes should include the pages from the front matter, which contains the title page and table of contents.

If the front matter is contained in pages 1 through 14, and the first chapter in the second volume is on page 491, the following commands will create suitable metadata values:

<meta name="pdf.output.1" string="1-490:Vol1.pdf"/>
<meta name="pdf.output.2" string="1-14,491-:Vol2.pdf"/>

When TopLeaf is instructed to create a PDF, three files will be created in the same folder. The first will contain all of the pages and have the name selected by the user. The other two will be called “Vol1.pdf” and “Vol2.pdf”.