Re: SCons PDF docs

Dirk Bächle <[email protected]>
Newsgroups gmane.comp.programming.tools.scons.devel
Message-ID <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.