ANNOUNCEMENT: Live Wireshark University & Allegro Packets online APAC Wireshark Training Session
July 17th, 2024 | 10:00am-11:55am SGT (UTC+8) | Online

Wireshark-dev: Re: [Wireshark-dev] Problem (and fix?) building pdfs from docbook

From: Ulf Lamping <ulf.lamping@xxxxxx>
Date: Mon, 19 May 2008 22:31:27 +0200
Joerg Mayer schrieb:
I'm running opensuse-factory with fop-0.94.
When trying to build the documentation, it failed. After making the follwing
change I could build the docs again:

Index: custom_layer_pdf.xsl
===================================================================
--- custom_layer_pdf.xsl        (revision 25305)
+++ custom_layer_pdf.xsl        (working copy)
@@ -9,7 +9,9 @@

 <!-- create pdf bookmarks -->
 <!-- Disable this since FOP 0.93 doesn't handle them, yet -->
+<!--
 <xsl:param name="fop.extensions" select="1"/>
+-->

 <!-- don't use the draft mode (no loading of image from the web) -->
 <xsl:param name="draft.mode" select="no"/>

Can anyone who actually understands a bit about docbook let me know whether
this fix is correct or will break things for others?
AFAIK, this will remove clickable bookmarks in the PDF files, which would be a bad thing - as they are really helpful when working with the PDF.


http://docbook.sourceforge.net/release/xsl/current/doc/fo/fop.extensions.html

suggests, that this setting should have no effect on FOP versions beyond 0.20.5, but this obviously seems to be not true.


Could you check, if

<xsl:param name="fop1.extensions" select="1"/>

works for you and produces bookmarks on the pdf?


I'm not really sure how to continue here ...

Regards, ULFL