388 lines
6.8 KiB
HTML
388 lines
6.8 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Requirements</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="Introduction"
|
|
HREF="intro.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Installing Processing Tools - OpenJade"
|
|
HREF="inst-openjade.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="intro.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="inst-openjade.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="sect1"
|
|
><H1
|
|
CLASS="sect1"
|
|
><A
|
|
NAME="requirements"
|
|
></A
|
|
>2. Requirements</H1
|
|
><P
|
|
>You'll have to download and compile only one package (OpenJade). This HOWTO will explain the compilation process, but you should be familiar with installing from source code. </P
|
|
><P
|
|
>Most of the packages that we need are located at <A
|
|
HREF="http://www.tldp.org/authors/index.html#resources"
|
|
TARGET="_top"
|
|
>The Linux Documentation Project (TLDP)</A
|
|
> website.</P
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN196"
|
|
></A
|
|
>2.1. Pre-requirements</H2
|
|
><P
|
|
> Create a directory <TT
|
|
CLASS="filename"
|
|
>/tmp/downloads</TT
|
|
>. We will use this directory to store the downloaded source code. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN200"
|
|
></A
|
|
>2.2. OpenJade</H2
|
|
><P
|
|
>OpenJade will be used to process DocBook documents. OpenJade can be downloaded from: <A
|
|
HREF="http://openjade.sourceforge.net/"
|
|
TARGET="_top"
|
|
>http://openjade.sourceforge.net/</A
|
|
>. </P
|
|
><P
|
|
>At the time of writing this document OpenJade 1.3.1 was available. Download the openjade-1.3.x.tar.gz file.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN205"
|
|
></A
|
|
>2.3. DocBook DTDs</H2
|
|
><P
|
|
>All the DocBook DTDs are available from The Linux Documentation Project website at <A
|
|
HREF="http://www.tldp.org/authors/index.html#resources"
|
|
TARGET="_top"
|
|
>http://www.tldp.org/authors/index.html#resources</A
|
|
></P
|
|
><P
|
|
>Please download <A
|
|
HREF="http://www.tldp.org/authors/tools/docbk41.zip"
|
|
TARGET="_top"
|
|
>DocBook SGML v4.1</A
|
|
>, <A
|
|
HREF="http://www.tldp.org/authors/tools/docbk31.zip"
|
|
TARGET="_top"
|
|
>DocBook SGML v3.1</A
|
|
>, and <A
|
|
HREF="http://www.tldp.org/authors/tools/docbkx412.zip"
|
|
TARGET="_top"
|
|
>DocBook XML v4.1.2</A
|
|
>. </P
|
|
><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
|
|
>Please download all the zip archives.</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN216"
|
|
></A
|
|
>2.4. ISO Entities</H2
|
|
><P
|
|
> <A
|
|
HREF="http://www.tldp.org"
|
|
TARGET="_top"
|
|
>The Linux Documentation Project</A
|
|
> has packaged all the Entities into one big tar file and placed it at <A
|
|
HREF="http://www.tldp.org/authors/tools/entities.tar.gz"
|
|
TARGET="_top"
|
|
>http://www.tldp.org/authors/tools/entities.tar.gz</A
|
|
> for the convenience of the users. Thanks to TLDP for this. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN221"
|
|
></A
|
|
>2.5. Norman Walsh's DSSSL</H2
|
|
><P
|
|
>Norman Walsh's DSSSL can be downloaded from the DocBook project website at <A
|
|
HREF="http://sourceforge.net/project/showfiles.php?group_id=21935"
|
|
TARGET="_top"
|
|
>http://sourceforge.net/project/showfiles.php?group_id=21935</A
|
|
>. </P
|
|
><P
|
|
> At the time of writing this document docbook-dsssl-1.7.6 was available. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN226"
|
|
></A
|
|
>2.6. LDP customized DSL stylesheets</H2
|
|
><P
|
|
> LDP DSL is a customized style sheet used by <A
|
|
HREF="http://www.tldp.org"
|
|
TARGET="_top"
|
|
>The Linux Documentation Project (TLDP)</A
|
|
>. It is an extension to Norman Walsh's DSSSL. It add things like background and Table of Contents. It can be downloaded from <A
|
|
HREF="http://www.tldp.org/authors/tools/ldp.dsl"
|
|
TARGET="_top"
|
|
>http://www.tldp.org/authors/tools/ldp.dsl</A
|
|
>. </P
|
|
><P
|
|
>ldp.dsl requires Normal Walsh's DSSSL</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN232"
|
|
></A
|
|
>2.7. HTMLDOC (Optional)</H2
|
|
><P
|
|
>HTMLDOC can be used for converting the HTML to PDF. If you would like to produce PDF documents, please download HTMLDOC from <A
|
|
HREF="http://www.easysw.com/htmldoc/software.php"
|
|
TARGET="_top"
|
|
>http://www.easysw.com/htmldoc/software.php</A
|
|
> </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN236"
|
|
></A
|
|
>2.8. Norman Walsh's XSL (Optional)</H2
|
|
><P
|
|
>This is not necessary. But if you would like to serve DocBook 4.1.2 XML content using Tomcat + Cocoon, you will need Norman Walsh's XML Style Sheets.</P
|
|
><P
|
|
>The Style Sheets are available for download at <A
|
|
HREF="http://sourceforge.net/projects/docbook/"
|
|
TARGET="_top"
|
|
>http://sourceforge.net/projects/docbook/</A
|
|
>.</P
|
|
><P
|
|
>Please download the package called docbook-xsl.</P
|
|
><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
|
|
>Recently docbook-xsl ver. 1.57.0 was released. This document is verified with the latest version, and appropriate modifications have been made. If you still encounter any errors please email me @ <TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:saqib@seagate.com"
|
|
>saqib@seagate.com</A
|
|
>></TT
|
|
></P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="AEN246"
|
|
></A
|
|
>2.9. LDP Customized XSL (Optional)</H2
|
|
><P
|
|
>Also download the LDP Customized XSL from <A
|
|
HREF="http://my.core.com/~dhorton/docbook/tldp-xsl/"
|
|
TARGET="_top"
|
|
>http://my.core.com/~dhorton/docbook/tldp-xsl/</A
|
|
></P
|
|
></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="intro.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="inst-openjade.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Introduction</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Installing Processing Tools - OpenJade</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |