Getting DocBook to work with Jade and DSSSL is regrettably not as straightforward as it should be. In the following, I outline my solution for Win NT, using Cygwin.

  1. To get started, follow the installation steps outlined in Markus Hoenicka's SGML for Windows NT site.

    I've installed Cygwin as my Unix shell. I have not installed Emacs (a pox on 't; I use UniRed, and any XML-aware editor will do, WYSIWYG or not.) I likewise have not installed Gnuserv, Ghostscript, PSGML or TDTD, or TeX. You may want to install them for your own purposes; that's up to you.

  2. Once you've installed OpenJade, DocBook, and the DocBook stylesheets, you'll now need to rearrange your directories and catalog files so that the installation actually works. This gave me no end of hassle; the configuration that ended up working is that outlined in a recent posting to the Docbook-apps mailing list by Rune Enggaard Jensen. The main point of this is to make sure that Jade does not barf on seeing XML entities instead of SGML entities.

  3. Next, install in a directory the subdirectories docbooktools, lessons and brochure.

  4. From docbooktools, you will need to copy across the customised DSSSL drivers to where the other DSSSL files are. Go to the directory where you've placed the DocBook DSSSL stylesheets. Put my_docbook.print.dsl, my_docbook.paperback.dsl and my_docbook.tex.dsl in the print subdirectory, and my_docbook.html.dsl in the html subdirectory. (If I had time, I'd write a shell script to do this automagically; mayhaps someone else will.)

  5. To actually generate output from the DocBook, you then run make. There are four targets currently: rtf, paperback (generating an RTF file, page size 6 by 9 inches), tex and html. Because of RTF/OpenJade brain damage, Non-Latin1 Unicode doesn't show up properly in RTF; as a result, the stylesheet for RTF uses SILSophiaIPA for IPA.

  6. To go from the output TeX to a DVi file, you will need to run the preprocessor JadeTex. I haven't gotten this to work, but Paul Reinerfelt has (eventually), so he should be able to address queries.

Created and Maintained by: Nick Nicholas, nicholas@uci.edu
Created: 2001-4-12

Last revision: 2001-7-20