[Scons-dev] SCons PDF docs

[Dirk Bächle]

Hi Bill,

On 11.04.2016 23:43, Bill Deegan wrote:
> Dirk or anyone else super familiar with the doc toolchain,
>
>
> Is it possible to generate the docs with PDF bookmarks?
> (something like this : http://www.sagehill.net/docbookxsl/PdfBookmarks.html)
>
> It would be great to be able to navigate more easily.
>

yes that's very easy to accomplish. Just add the following parameter to the "pdf.xsl" of each document:

--- a/doc/user/pdf.xsl	Sat Apr 09 19:04:42 2016 -0400
+++ b/doc/user/pdf.xsl	Tue Apr 12 01:29:26 2016 +0200
@@ -33,6 +33,7 @@
  	<xsl:include href="scons_title.xsl"/>
  <xsl:param name="l10n.gentext.default.language" select="'en'"/>
  <xsl:param name="section.autolabel" select="1"></xsl:param>
+<xsl:param name="fop1.extensions" select="1"></xsl:param>
  <xsl:param name="section.label.includes.component.label" select="1"/>
  <xsl:param name="paper.type" select="'letter'"></xsl:param>
  <xsl:param name="body.start.indent">0pt</xsl:param>



Note how this is only correct for the FOP renderer, but I guess that's the only one we have at the moment...at least when building a 
release, right?

Best regards,

Dirk