424 lines
7.2 KiB
HTML
424 lines
7.2 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Introduction</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
|
|
REL="HOME"
|
|
TITLE="DocBook XML/SGML Processing Using OpenJade"
|
|
HREF="index.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="DocBook XML/SGML Processing Using OpenJade"
|
|
HREF="index.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Requirements"
|
|
HREF="requirements.html"></HEAD
|
|
><BODY
|
|
CLASS="sect1"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
SUMMARY="Header navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>DocBook XML/SGML Processing Using OpenJade</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="requirements.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="sect1"
|
|
><H1
|
|
CLASS="sect1"
|
|
><A
|
|
NAME="intro"
|
|
></A
|
|
>1. Introduction</H1
|
|
><P
|
|
>Some Acronyms:</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
>SGML - Standard Generalized Markup Language</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>XML - Extensible Markup Language</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>RTF - Rich Text Format</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>HTML - HyperText Markup Language</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>PDF - Portable Document Format</P
|
|
></LI
|
|
></OL
|
|
><P
|
|
> 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).</P
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="copyright"
|
|
></A
|
|
>1.1. Copyright and License</H2
|
|
><P
|
|
> 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 <A
|
|
HREF="http://www.gnu.org/copyleft/fdl.html"
|
|
TARGET="_top"
|
|
>http://www.gnu.org/copyleft/fdl.html</A
|
|
>. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN117"
|
|
></A
|
|
>1.2. Credits</H2
|
|
><P
|
|
>All praise is due to <STRONG
|
|
><EM
|
|
></EM
|
|
>Allah</STRONG
|
|
>, <STRONG
|
|
>The Lord of the Worlds</STRONG
|
|
>. All credits go to <STRONG
|
|
>Allah</STRONG
|
|
>. Any mistake in this document is my own fault.</P
|
|
><P
|
|
>Additionally, I would like to acknowledge the following people for their valuable contributions to this document:</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
> Eric Safern <TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:esafern (at) lrn.com"
|
|
>esafern (at) lrn.com</A
|
|
>></TT
|
|
> - For updates related to Cocoon and JRE. <A
|
|
HREF="http://www.timebytes.com/"
|
|
TARGET="_top"
|
|
>http://www.timebytes.com/</A
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Greg Ferguson <TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:gferg (at) hoop.timonium.sgi.com"
|
|
>gferg (at) hoop.timonium.sgi.com</A
|
|
>></TT
|
|
> - for very helpful hints/suggestions on the docbook mailing list</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Kristin Thomas <TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:kristint (at) us.ibm.com"
|
|
>kristint (at) us.ibm.com</A
|
|
>></TT
|
|
> - For the initial review of this document.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Luc de Louw <TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:luc (@) delouw.ch"
|
|
>luc (@) delouw.ch</A
|
|
>></TT
|
|
> - For suggesting the HTMLDOC (PDF -> HTML) section.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Lloyd D Budd <TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:ldp (@) foolswisdom.org"
|
|
>ldp (@) foolswisdom.org</A
|
|
>></TT
|
|
> - For suggestions on improving most of the sections of the document.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Andrew Shugg <TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:andrew (@) neep.com.au"
|
|
>andrew (@) neep.com.au</A
|
|
>></TT
|
|
> - For fixing errors in the ver 2.0 of this document. <A
|
|
HREF="http://www.neep.com.au/"
|
|
TARGET="_top"
|
|
>Neep Consulting</A
|
|
></P
|
|
></LI
|
|
></OL
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN146"
|
|
></A
|
|
>1.3. What is DocBook?</H2
|
|
><P
|
|
> 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. </P
|
|
><P
|
|
> 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. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN150"
|
|
></A
|
|
>1.4. What is DSSSL?</H2
|
|
><P
|
|
>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.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN153"
|
|
></A
|
|
>1.5. What do we need?</H2
|
|
><P
|
|
>The tools needed to set up OpenJade for converting SGML and XML are: </P
|
|
><P
|
|
></P
|
|
><UL
|
|
><LI
|
|
><P
|
|
>OpenJade</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>DocBook DTDs</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>ISO Entities</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Norman Walsh's DSSSL</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>LDP DSL</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>HTMLDOC (optional)</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Norman Walsh's XSL (optional)</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>LDP XSL (optional)</P
|
|
></LI
|
|
></UL
|
|
><DIV
|
|
CLASS="note"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="note"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/note.gif"
|
|
HSPACE="5"
|
|
ALT="Note"></TD
|
|
><TH
|
|
ALIGN="LEFT"
|
|
VALIGN="CENTER"
|
|
><B
|
|
>Note</B
|
|
></TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
> </TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
>All of these packages are free and available for download on the net. The next chapter explains how to download these packages.</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN176"
|
|
></A
|
|
>1.6. Assumptions</H2
|
|
><P
|
|
> This document assumes that you have the following already installed on your system. </P
|
|
><P
|
|
></P
|
|
><UL
|
|
><LI
|
|
><P
|
|
>gzip - available from <A
|
|
HREF="http://www.gnu.org/directory/"
|
|
TARGET="_top"
|
|
>http://www.gnu.org/directory/</A
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>gcc and GNU make - available from <A
|
|
HREF="http://www.gnu.org/directory/"
|
|
TARGET="_top"
|
|
>http://www.gnu.org/directory/</A
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>unzip - available from <A
|
|
HREF="http://www.info-zip.org/pub/infozip/"
|
|
TARGET="_top"
|
|
>http://www.info-zip.org/pub/infozip/</A
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Standard Unix utilities - tar, mkdir, mv ...</P
|
|
></LI
|
|
></UL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="H"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="requirements.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>DocBook XML/SGML Processing Using OpenJade</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Requirements</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |