To generate HTML or PDF files out of the source XML, you will need the following:

To get the Bluefish XML source, we use cvs. To login:

$ cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/bluefish login

You will be prompted for a password. Since we are logging in anonymously, you can just hit enter without providing any password. Next we will checkout the directory containing the Bluefish documentation:

$ cvs -z3 -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/bluefish co bluefish-gtk2/doc

This will download all the files to your system in the directory bluefish-gtk2/doc/. Next, we will get the DTD and the stylesheets, which are in CVS under bluefish-doctools:

$ cvs -z3 -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/bluefish co bluefish-gtk2/doc

Finally, you need the libxslt libraries installed on your system. libxslt is distributed as part of the GNOME desktop environment and is packaged for most Linux distributions. Fink provides the packages for Mac OS X. The XSLT processor xsltproc is provided by the libxslt library and is the command which will convert the DocBook source into HTML files.

The files must be in the right place.

To create a one-page HTML file: To break the sections into multiple pages with navigation links (a process known as chunking):