One page to docbook bliss mawi docbook@mawi.org 2003 Short stepwise guide to installing docbook with some custom scripts to quickly allow you to generate content in HTML, HTML Help and PDF by a click. 1 June 2003 Initial draft 2 Oct 2 2003 Fixed several small problems in scripts, edited text The latest version of this document is kept in several formats here: HTML, PDF, HTML Help, original docbook XML source.

You need to do this: Optional: Get docbook here: , extract somewhere. Get Docbook XSL (the code doing the converting) (homepage: ), I found it under "Projects", "XSL..." linked to download page here: . Remember where you extract it since you will need that information below. Get java here (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 and extract someplace (remember where!) (I found it here: - choose binary of course). You also need to get jimi for the pdfs, check out the FOP releasenotes for info, I found jimi here: , 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: ), I found it here: . 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 ), 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. After all this is done, try it out on a file! It takes a while - so wait for it. It will create a "file-pub" directory with all generated files. Note! My scripts only work on files with no spaces! So please replace spaces with underscores. This was done really quick! Feedback any problems please; thx!

bob Stayton Sagehill Enterprises 2002,2003 URL: Dave Pawson 2001 URL: Norman Walsh Bob Stayton Jiri Kosek 1999, 2000, 2001, 2002 URL: Dave Liske 2001 FAQ on mvps site, not the MS HH FAQ - URL: