1. Introduction

Some Acronyms:

SGML - Standard Generalized Markup Language
XML - Extensible Markup Language
RTF - Rich Text Format
HTML - HyperText Markup Language
PDF - Portable Document Format

The objective of this document is to setup OpenJade to convert DocBook 3.2 and 4.2 Standard Generalized Markup Language (SGML) and Extensible Markup Language (XML) documents to HyperText Markup Language (HTML), Rich Text Format (RTF), and Portable Document Format (PDF).

1.1. Copyright and License

This document is Copyright 2001 by Saqib Ali. 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. A copy of the license is available at http://www.gnu.org/copyleft/fdl.html.

1.2. Credits

All praise is due to Allah, The Lord of the Worlds. All credits go to Allah. Any mistake in this document is my own fault.

Additionally, I would like to acknowledge the following people for their valuable contributions to this document:

Eric Safern <esafern (at) lrn.com> - For updates related to Cocoon and JRE. http://www.timebytes.com/
Greg Ferguson <gferg (at) hoop.timonium.sgi.com> - for very helpful hints/suggestions on the docbook mailing list
Kristin Thomas <kristint (at) us.ibm.com> - For the initial review of this document.
Luc de Louw <luc (@) delouw.ch> - For suggesting the HTMLDOC (PDF -> HTML) section.
Lloyd D Budd <ldp (@) foolswisdom.org> - For suggestions on improving most of the sections of the document.
Andrew Shugg <andrew (@) neep.com.au> - For fixing errors in the ver 2.0 of this document. Neep Consulting

1.3. What is DocBook?

DocBook is a document type definition (DTD). A DTD defines the syntax of a document. DocBook describes the types of structure and formats to use in technical documents. It is commonly used because of its simplicity and completeness.

A DTD defines the syntax of a document - essentially it is a 'rule book' that describes the sets of tags and attributes that will be used to describe specific kinds of content. So DocBook is a "rule book" that is used for writing documents. Every tag that is used in writing the document, must be defined very specifically and formally in the DTD.

1.4. What is DSSSL?

A Document Style Semantics and Specification Language (DSSSL) defines how to convert an Standard Generalized Markup Language (SGML) document into a human-readable viewing format such as HTML, RTF and PDF.

1.5. What do we need?

The tools needed to set up OpenJade for converting SGML and XML are:

OpenJade
DocBook DTDs
ISO Entities
Norman Walsh's DSSSL
LDP DSL
HTMLDOC (optional)
Norman Walsh's XSL (optional)
LDP XSL (optional)

	Note
	All of these packages are free and available for download on the net. The next chapter explains how to download these packages.

1.6. Assumptions

This document assumes that you have the following already installed on your system.

gzip - available from http://www.gnu.org/directory/
gcc and GNU make - available from http://www.gnu.org/directory/
unzip - available from http://www.info-zip.org/pub/infozip/
Standard Unix utilities - tar, mkdir, mv ...