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 following people for their valuable contributions to this document:
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 suggestions on HTMLDOC (PDF -> HTML) section
Lloyd D Budd <ldp@foolswisdom.org> - For suggestions on improving most of the sections of the document
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 verfy 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 format.
1.5. What do we need?
The tools needed to set up OpenJade for converting SGML and XML are:
OpenJade
Entities
Norman Walsh's DSSSL
DocBook DTDs
LDP DSL
 | 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
gcc and GNU make - available from http://www.gnu.org