To generate HTML, PDF or PostScript files out of the source XML, you will need the following:
the Bluefish manual source files via CVS
DocBook XSL style sheets 1.71.0
XSLT Processors and Parsers: we use xsltproc for HTML production, and fop for PDF and PostScript production.
xmllint for validating all files
Here are the procedures to install the required files:
Procedure C.1. Getting the Bluefish manual source files
First, think about where in the filesystem you would like to build the manual. Let us assume you choose your home directory. So, from your home directory, login to Bluefish's CVS repository by issuing the command::
$cvs -d :pserver:email@example.com:/cvsroot/bluefish \ login
Hit enter at the prompt when asked for your password.
Checkout the directory containing the Bluefish documentation:
$cvs -z3 -d :pserver:firstname.lastname@example.org:/cvsroot/bluefish \ co bluefish-doc
This will download the bluefish-doc CVS module, containing the Bluefish manual source files, to your system in a newly created directory
Procedure C.2. Installing DocBook and DocBook XSL
Install DocBook 4.4 for your distribution
Install DocBook XSL version 1.71.0 if it is available for your distribution
Otherwise, get it from the DocBook Project pages on SourceForge.net and unpack it into the
Procedure C.3. Installing the xslt processors and parsers
Install libxslt if needed.
If you wish to build PDF or PostScript versions of the manual, you will need the Formatting Objects Processor (FOP) package from Apache. If it is not already installed on your system, get the latest binary distribution from the FOP download page on the Apache web site.
Unpack it into the
$tar zxvf fop-0.20.5-bin.tar.gz -C ~/bluefish-doc
The files will be unpacked to a directory called
$mv ~/bluefish-doc/fop-0.20.5 ~/bluefish-doc/fop
FOP does not yet support embedding PNG images in pdf files. To get PNG support, we need from Java Advanced Imageing (JAI) or the JIMI Software Development Kit (especially for Debian and Ubuntu users, read
For Linux, download the CLASSPATH version,
jai-1_1_2-lib-linux-i586.tar.gz. Unpack and copy the files
jai_codec.jar files to
~/bluefish-doc/fop/lib. Debian and Ubuntu users running fop with JIMI-support download
jimi1_0.(zip|tar.Z) and place
JAI and JIMI support are available for FOP release 0.20.5 and later.