Including and excluding bookmarks

By default, all bookmarks from all source documents are included in the result document. Therefore, you do not need to do anything special to preserve bookmarks. In the following example, the result document contains the bookmarks from doc2, doc3, and doc4, in that order. The first (level 1) bookmark from doc3 follows the last bookmark from doc2, and so on.

Example: Preserving bookmarks

<PDF result="doc1">

	<PDF source="doc2"/>

	<PDF source="doc3"/>

	<PDF source="doc4"/>

</PDF>

To exclude bookmarks from a source document, use the NoBookmarks element.

Example: Removing bookmarks from a source document

<PDF result="doc1">

	<PDF source="doc2"/>

	<PDF source="doc3">

		<NoBookmarks/>

	</PDF>

	<PDF source="doc4"/>

</PDF>

In the example above, bookmarks from doc2 and doc4 are included in the result document; bookmarks from doc3 are not included.

In the following example, because the NoBookmarks element is a child of the PDF result element, none of the bookmarks in its scope are included.

Example: Removing all bookmarks

<PDF result="doc1">

	<PDF source="doc2"/>

	<PDF source="doc3"/>

	<PDF source="doc4"/>

	<NoBookmarks/>

</PDF>

In the following example, the NoBookmarks element is a child of a PDFGroup element. Therefore, no bookmarks are included from the source documents within the PDFGroup element. Only the bookmarks from doc4 are included in the result.

Example: Selectively removing bookmarks

<PDF result="doc1">

	<PDFGroup>

		<PDF source="doc2"/>

		<PDF source="doc3"/>

		<NoBookmarks/>

	<PDFGroup/>

	<PDF source="doc4"/>

</PDF>

NoBookmarks and Bookmarks cannot be siblings.

You can also include bookmarks from PDF documents other than your PDF source documents. One way to do this is to use the Bookmarks element as a filter element.

Example: Using a bookmarks filter element

<PDF result="doc1">

	<PDF source="doc2"/>

	<Bookmarks>

		<PDF source="doc3"/>

		<PDF source="doc4"/>

	</Bookmarks>

</PDF>

In this example, the Bookmarks element filters the bookmarks from doc3 and doc4 and adds them to the result. No content from doc3 and doc4 other than bookmarks are included in the result. doc2 provides PDF page content as well as bookmarks (if any) to the result.

The same task could be accomplished by exporting the bookmarks from doc3 and doc4 to an XML representation and then importing the bookmarks into doc2. The next section describes this process in more detail.