Copyright © 2004-2019 Berndt E. Schwerdtfeger
First published 2004-07-19
|Revision 1.16||Date: 2020-01-24|
|updated to DocBook version 5.1 and FOP version 2.3|
|Revision 1.0||Date: 2004-07-19|
Table of Contents
This article describes how to install a documentation system based on DocBook 5 XML on a Windows system.
In this paper I describe how to install a professional documentation system on a Windows platform, which is based on the DocBook and XML standards. I will not explain how to write DocBook XML source text. Instead you might want to look up the DocBook Wiki as a good source for books, tutorials and other DocBook documentation.
My goal is to describe the environment, including its installation and configuration, and give some examples of its usage.
This new revision reflects new releases of required packages and updates the hyperlinks to the Internet.
I assume that you
You can download the up-to-date version of the OpenSource Java Development Kit from OpenSource Java Development Kit .
The same source document written in DocBook 5 XML can be used to produce pdf or HTML output through the same formatting objects processor FOP. Internally this is done in two steps as a transformation and a formatting.
The necessary packages are available under the Apache License. The appropriate web sites for downloading these packages will be given below.
The following packages are required
The current version of DocBook 5 is 5.1 released 2016-11-22. The version 5.0 was a complete rewrite in RELAX NG. The DocBook stylesheets are at version 1.79.1 released 2018-07-13.
The current version of Apache FOP is 2.3 released 2018-05-18.
The DocBook XSL stylesheets are located at Sourceforge docbook-xsl, download the latest files (version 1.79.1 as of 2019-10-23).
Locate the FOP package from the Apache FOP binaries.
Unpack the zip archives into some convenient place. On my system I have chosen the directories
You need to do three things
JAVA_HOMEto the path pointing to your Java installation
On my system I have set
c:\xml\fop-2.3\fop to the
as well as
The generation of HTML output is performed by