PDF files can optionally include an active table of contents that is displayed alongside the pages in the PDF viewer. These references are called bookmarks.
PDF bookmarks are generated using special functions in each XSL-FO processor because XSL cannot produce them directly. So if you are using Apache FOP, for example, you need to turn on the FOP extension functions by setting the fop.extensions
parameter to 1. For example:
xsltproc --output myfile.fo \
--stringparam fop.extensions 1 \
fo/docbook.xsl myfile.xml
If you are instead using Antenna House's XSL Formatter, you should set the axf.extensions
parameter to 1, or if you are using RenderX's XEP you
should set the xep.extensions
parameter to 1. When you turn on one of these extensions, special FO elements and/or
attributes are written by the DocBook XSL stylesheets to the FO file. These
elements and attributes belong to processor-specific namespaces. By
convention, the following namespace prefixes are used: fox
for FOP, axf
for
Antenna House, and rx
for XEP. Those special FO elements are only
recognized by the specific processor being used. If you turn on the
wrong extensions, you probably will not be successful.
DocBook XSL: The Complete Guide - 4th Edition | PDF version available | Copyright © 2002-2007 Sagehill Enterprises |