The Goldfish Chronicles

Quick potted how to get started with DocBook:

1) Grab a docbook reference. I’m using the DocBook book from Norman Walsh [seems quite an authority]. There are newer, online versions but they’re not complete yet. You can also find it at OReilly and other places.

2) Grab Xalan. I went and grabbed the latest stable Xalan. The book warns you against Xalan, but I suspect that is very dated information [indeed, the book is quite dated. So expect to have to pick things up through the occasional surprise].

3) Get yerself a nice set of XSL’s for converting DocBook to other formats. I’m using the stylesheets at the DocBook project at sourceforge.

4) Write your book/article/faq/man-page.

5) Using the instructions at Xalan setup your classpath and run java org.apache.xalan.xslt.Process -IN yourbook.xml -XSL html/docbook.xsl -OUT docbook.html

This entry was posted on Tuesday, October 29th, 2002 at 7:05 am and is filed under Tech. You can follow any responses to this entry through the RSS 2.0 feed. Both comments and pings are currently closed.