Adding blank pages

You can use the BlankPage element to add pages to your document. Such pages are blank in the sense that they begin with no text or graphics. However, as with all pages in an assembled document, you can add page content such as headers and watermarks, and you can set the page properties and page labels.

A typical use for adding a blank page is to make the number of pages in a chapter, section, or document be even. As a result, the first page of the next section starts on an odd-number page. To do this, you specify true for the value of the forceEven attribute, which means that a blank page is added only if the number of pages up to that point in the result document is odd.

In the following example, each chapter is forced to contain an even number of pages before the next chapter is assembled into the result document.

Example: Adding blank pages

<PDF result="doc.pdf">

	<PDF source="Chap1.pdf"/>

	<BlankPage forceEven="true"/>

	<PDF source="Chap2.pdf"/>

	<BlankPage forceEven="true"/>

	<PDF source="Chap3.pdf"/>

	<BlankPage forceEven="true"/>

</PDF>

Note: Whether a page is odd or even for this purpose is determined only by the ordinal page number of the page in the result document. It is not determined by the position of the page in a PDF source or PDFGroup nor by the page label.

In the next example, a blank page is added only at the end of the result document, if necessary to make the pages even. The page, if it exists, will have a watermark specified by the Watermark element that is a child of the BlankPage element.

Example: Adding a blank page with a watermark

<PDF result="doc3.pdf">

	<PDF source="doc1.pdf"/>

	<PDF source="doc2.pdf"/>

	<BlankPage forceEven="true">

		<Watermark>

			<StyledText font="Helvetica, 14">

				<p>This page intentionally left blank</p>

			</StyledText>

		</Watermark>

	</BlankPage>

</PDF>

As with other pages, pages added by the BlankPage element inherit page properties and content specified for parent elements, as well as those specified as children of BlankPage. If a value for either PageSize or PageRotation is not specified within the scope of the BlankPage element (see Scope of page elements), the value is taken from the PDF result page just before the blank page, or the page after if there is no page before.

If a page label is not specified within the scope of the blank page, the following occurs:

•	If the document contains no other page labels, the blank page has no page labels.

•	If the document contains page labels, the blank page takes its labeling style from the previous page in the assembly, as if <PageLabel mode="Continue"/> were specified. If there are no pages prior to the blank page, it takes a filler label that is equal to the ordinal page number.

Current page: http://livedocs.adobe.com/livecycle/es/sdkHelp/programmer/sdkHelp/assemblePDFTableOfContents.100.4.html