Docbook Quick Get Started for Windows

Optional: Get docbook here: http://www.oasis-open.org/docbook/xml/, extract somewhere.

Get Docbook XSL (the code doing the converting) (homepage: http://docbook.sourceforge.net/), I found it under "Projects", "XSL..." http://docbook.sourceforge.net/projects/xsl/index.html linked to download page here: http://sourceforge.net/project/showfiles.php?group_id=21935. Remember where you extract it since you will need that information below.

Get java here http://java.sun.com/j2se/ (click downloads) if you dont have it

Get instant saxon (that's what I did, easy one .exe - scroll down). It contains one exe, put it in your C:\WINDOWS (95/98/XP) or C:\WINNT catalogue.

To make PDFs, get FOP from http://xml.apache.org/ and extract someplace (remember where!) (I found it here: http://xml.apache.org/fop/download.html - choose binary of course).

You also need to get jimi for the pdfs, check out the FOP releasenotes for info, I found jimi here: http://java.sun.com/products/jimi/, like the FOP releasenotes say "then extract the archive, then copy JimiProClasses.zip to FOP's lib dir and rename it to jimi-1.0.jar."

To make HTML Help you need the HTML Help workshop (as of this writing homepage here: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconhh1start.asp), I found it here: http://go.microsoft.com/fwlink/?LinkId=14188. Install it, go to its directory (normally C:\Program Files\HTML Help Workshop) and copy the program file "hhc.exe" to your windows catalogue (C:\WINDOWS or C:\WINNT on WinNT/2000)

Finally, get my scripts (here http://mawi.org/articles/docbook-scripts.zip), extract somewhere, and make a few small edits: In "docmake.bat", edit the following lines to where you extracted the scripts and where you extracted fop:

SET scriptpath=C:\priv\stuff\docbook\scripts
SET defstylepath=%scriptpath%
SET fop=C:\priv\stuff\docbook\fop-0.20.5\fop.bat

and in style-hh.xsl, style-html.xsl, style-pdf.xsl - edit the italic part of the following line to where you extracted the docbooks XSL:

<xsl:import href="file:///C:/Program Files/Altova/xmlspy/Stylesheets/docbook-xsl-1.61.3/htmlhelp/htmlhelp.xsl"/> 

. Finally, copy "docmake.bat" to your windows catalogue (C:\WINDOWS or C:\WINNT) and run the registry to make "Docmake XML make" menuitem appear on all XML files context menu in windows file explorer.