DocBook Framework for OS/2 and eComStation

Download

Download DocBook Framework for OS/2 version 1.0.0 as a WarpIn package.
Alternatively, the framework can be also downloaded from the OS/2 Hobbes Archive.

 

System Requirements

The framework is a bundle of Java software, data files, and Rexx scripts. Therefore, you will need the following stuff installed:

• Rexx – Every OS/2 and eComStation systems comes with Rexx installed by default.
• Java. Use Golden Code or InnoTek Java 1.4, if you can. However, IBM Java 1.3 should also work. As Golden Code Java is not publicly available anymore, you will very likely use InnoTek Java 1.4.2, which is bundled with eComStation.
• WarpIn for installation/deinstallation. Newer eComStation distributions come with WarpIn already installed.

Installation and Deinstallation

DocBook Framework is installed automatically using WarpIn. During installation, your CONFIG.SYS will be modified. If you don't allow WarpIn to perform the modification, you will have to:

• either modify CONFIG.SYS on your own by adding the "...\Scripts" directory to your PATH, or
• add the "...\Scripts" directory to your PATH from the command line every time you use the framework.

In addition, java.exe must be in your PATH. It is assumed that PATH already contains a Java "...\jre\bin" directory and no checks are performed, neither during installation nor during normal operation.

Before you start using the framework, take a little time to configure it. A few configuration files must be set up in order for the tools to operate properly. Please read the file PatchTheseFiles.TXT for more details. These changes can be performed automatically and future versions of the framework will contain a little configuration tool that will be executed during installation.

The framework can be uninstalled using WarpIn. You can also delete it manually, but then the WarpIn database will not be consistent with your hard disk's content and you will have to synchronize it.

Components of the Framework

The framework consists of the following components:

• DocBook 4 DTD and ISO entities.
• DocBook 4 XSL stylesheets that prescribe how DocBook documents should be converted into other formats.
• Saxon 6 - XSLT processor that converts a DocBook document into another format using a XSL stylesheet.
• FOP 0.20.5 - FO processor that converts an FO document (generated by Saxon) into a paged-media document.
• Rexx scripts that set up the environment properly before launching the programs.

Other software can be plugged into the framework, e.g. XML Mind FO Converter (XFC) or XEP. Rexx scripts for starting them are present in the distribution, but the programs could not be included because of their strict licenses. However, you can easily download them on your own and install them into the "...\SW\XFC" and "...\SW\XEP" directories. Look into the UsefulLinks.TXT file for links to the software.