DocBook XML Publishing System

A Win32 Installation

Rijk Ravestein

ICT Specialist
www.datraverse.com/technology

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.


Table of Contents

1. Introduction
2. XMLmind XML Editor M1.3
3. DocBook XML DTD 4.1
4. DocBook XLS Files
5. SAXON version 6.5.1
6. FOP version 0.20.3
7. XFC version 0.9
8. References
9. Open issues
A. Sample makefile for generating publications.

1. Introduction

The DocBook DTD is broadly viewed as the de-facto standard for writing technical documentation. The XML variant of the proven SGML edition is not officially endorsed yet by OASIS. Nevertheless, all the tools are available in open-source to setup a DocBook XML publishing system so you can generate multiple output formats based on a single XML source. Although, due to some bugs and incomplete implementations, not all output beyond straight HTML can be generated in equal quality, I believe XML is the way to go and is worth to invest in. Inevitably things will grow better. The choice for a Win32 implementation looks a bit peculiar considering I use open source tools. Why not use Linux? I do use Linux as a server platform, but practice is that Windows still is, at least for the majority of my clients, the desktop system of choice. The good news is that all the major tools are Java based. So I only need to use Microsofts nmake.exe for the build process and the Microsoft HTML Help Workshop to compile native windows helpfiles. Ofcource the DTD and XLS files are portable across operating systems. This article is not a tutorial but a hands-on guide to setup the system. My main purpose is to consolidate my research and (some) development in writing and showing you some DocBook at the same time.