[boost] [fop-0.91beta] setup instructions (was: [ANN] New documentation style sheet)

From: Eric Niebler (eric_at_[hidden])
Date: 2006-04-13 20:46:03

John Maddock wrote:
>>> Sincerely hoping someone proves me wrong....
>> Have you checked whether 0.91 beta supports them?
>>
>>  http://xmlgraphics.apache.org/fop
> 
> Thanks for the link, looks like might do, but I haven't been able to get it 
> working yet.
> 

It works, but it takes a bit of hacking. Kids, don't try this at home. 
;-) In addition to fop-0.91beta, you need to download a snapshot of the 
current docbook-xsl stylesheets from 
http://docbook.sourceforge.net/snapshots/. Next, you need to change your 
user-config.jam to point to these guys. Mine looks like:

using boostbook : C:/cygwin/home/ericne/docbook-xsl-snapshot/
                 : C:/cygwin/home/ericne/docbook-dtd-4.2/
                 ;

using fop : C:/cygwin/home/ericne/fop-0.91beta/fop.bat
           : C:/PROGRA~1/Java/j2re1.4.2_06
           ;

Next, you need to hack your doc's Jamfile.v2. Using xpressive as an example:

boostbook standalone
     :
         xpressive
     :
         <xsl:param>fop1.extensions=1
         <xsl:param>fop.extensions=0
     ;

Note the two xsl:params. After this, you should be ready to use 
fop-0.91beta to generate PDFs. Type "bjam --v2 pdf" and away you go.

If you are embedding png files, fop will complain that it can't find 
them. Just copy them to where fop is looking for them (somewhere deep in 
the bin.v2 directory) and rerun.

Looking at the end result, I can't say I think fop-0.91beta is an 
improvement. :-P Unless you *really* need to embed png files, I say 
stick with fop-0.20.X.

-- 
Eric Niebler
Boost Consulting
www.boost-consulting.com