560 lines
9.3 KiB
HTML
560 lines
9.3 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Download the Packages</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.63
|
|
"><LINK
|
|
REL="HOME"
|
|
TITLE="DocBook Install mini-HOWTO"
|
|
HREF="index.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Introduction"
|
|
HREF="intro.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Install the Packages"
|
|
HREF="install.html"></HEAD
|
|
><BODY
|
|
CLASS="SECT1"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>DocBook Install mini-HOWTO</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="intro.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="install.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="SECT1"
|
|
><H1
|
|
CLASS="SECT1"
|
|
><A
|
|
NAME="DOWNLOAD"
|
|
>2. Download the Packages</A
|
|
></H1
|
|
><P
|
|
>In this section, we will locate and download the software on the Internet.</P
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN111"
|
|
>2.1. OpenJade</A
|
|
></H2
|
|
><P
|
|
> OpenJade is an actively maintained open-source software project based
|
|
on the Jade package by <A
|
|
HREF="http://www.jclark.com/"
|
|
TARGET="_top"
|
|
>James Clark</A
|
|
>.
|
|
Download the lastest stable release at:
|
|
</P
|
|
><P
|
|
> <A
|
|
HREF="http://openjade.sourceforge.net/"
|
|
TARGET="_top"
|
|
>http://openjade.sourceforge.net/</A
|
|
>
|
|
</P
|
|
><P
|
|
> OpenJade also includes the OpenSP package and the TeX macros, <B
|
|
CLASS="COMMAND"
|
|
>jadetex</B
|
|
> and <B
|
|
CLASS="COMMAND"
|
|
>pdfjadetex</B
|
|
>
|
|
for converting files to <TT
|
|
CLASS="FILENAME"
|
|
>dvi</TT
|
|
> and <TT
|
|
CLASS="FILENAME"
|
|
>pdf</TT
|
|
>. The following programs are provided by this
|
|
package:
|
|
</P
|
|
><P
|
|
></P
|
|
><UL
|
|
><LI
|
|
><P
|
|
>openjade</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>onsgmls</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>osgmlnorm</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>ospam</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>ospent</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>osx</P
|
|
></LI
|
|
></UL
|
|
><P
|
|
> To use <B
|
|
CLASS="COMMAND"
|
|
>jadetex</B
|
|
> and <B
|
|
CLASS="COMMAND"
|
|
>pdfjadetex</B
|
|
> for making
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>dvi</TT
|
|
>, <TT
|
|
CLASS="FILENAME"
|
|
>ps</TT
|
|
>, and <TT
|
|
CLASS="FILENAME"
|
|
>pdf</TT
|
|
>, you must have
|
|
a working TeX (<B
|
|
CLASS="COMMAND"
|
|
>tex</B
|
|
>) installation. If you do not have TeX, check with your
|
|
Linux distribution for a binary package that can be downloaded and installed.
|
|
Otherwise, you can download the <SPAN
|
|
CLASS="PRODUCTNAME"
|
|
>teTeX</SPAN
|
|
> distribution
|
|
of TeX from:
|
|
</P
|
|
><P
|
|
> <A
|
|
HREF="http://www.tug.org/tetex/"
|
|
TARGET="_top"
|
|
>http://www.tug.org/tetex/</A
|
|
>
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN145"
|
|
>2.2. DocBook SGML DTD</A
|
|
></H2
|
|
><P
|
|
>The DocBook DTD for SGML and XML are maintained by a technical committee at
|
|
<A
|
|
HREF="http://www.oasis-open.org/"
|
|
TARGET="_top"
|
|
>Oasis-Open.ORG</A
|
|
>. Download the current
|
|
version (and any old versions you might need) of DocBook SGML at:
|
|
</P
|
|
><P
|
|
> <A
|
|
HREF="http://www.oasis-open.org/docbook/sgml/index.shtml"
|
|
TARGET="_top"
|
|
>http://www.oasis-open.org/docbook/sgml/index.shtml</A
|
|
>
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN151"
|
|
>2.3. ISO8879 ENTITY SGML</A
|
|
></H2
|
|
><P
|
|
> The entities define representations for special or untypeable symbols or characters, including
|
|
mathematical symbols, and the entities that you may be familiar with from HTML. These entity
|
|
files need to be installed for a proper configuration.
|
|
</P
|
|
><P
|
|
></P
|
|
><UL
|
|
><LI
|
|
><P
|
|
>Resources at <A
|
|
HREF="http://www.oasis-open.org/"
|
|
TARGET="_top"
|
|
>OASIS</A
|
|
>:
|
|
<P
|
|
></P
|
|
><UL
|
|
><LI
|
|
><P
|
|
><A
|
|
HREF="http://www.oasis-open.org/cover/topics.html#entities"
|
|
TARGET="_top"
|
|
>http://www.oasis-open.org/cover/topics.html#entities</A
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><A
|
|
HREF="http://www.oasis-open.org/cover/ISOEnts.zip"
|
|
TARGET="_top"
|
|
>http://www.oasis-open.org/cover/ISOEnts.zip</A
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><A
|
|
HREF="http://www.oasis-open.org/cover/isoENT-tar.gz"
|
|
TARGET="_top"
|
|
>http://www.oasis-open.org/cover/isoENT-tar.gz</A
|
|
></P
|
|
></LI
|
|
></UL
|
|
>
|
|
</P
|
|
></LI
|
|
></UL
|
|
><P
|
|
> <TT
|
|
CLASS="FILENAME"
|
|
>ISOEnts.zip</TT
|
|
> can simply be <B
|
|
CLASS="COMMAND"
|
|
>unzip</B
|
|
>ped into the directory where the DocBook DTD
|
|
is <B
|
|
CLASS="COMMAND"
|
|
>unzip</B
|
|
>ped without requiring anything else but
|
|
the files in <TT
|
|
CLASS="FILENAME"
|
|
>isoENT-tar.gz</TT
|
|
> are also needed. Again, the files in <TT
|
|
CLASS="FILENAME"
|
|
>isoENT-tar.gz</TT
|
|
>
|
|
are to be <B
|
|
CLASS="COMMAND"
|
|
>unzip</B
|
|
>ped into the DocBook DTD directory (see next section on installing for details),
|
|
but the filenames end with "<TT
|
|
CLASS="FILENAME"
|
|
>.ent</TT
|
|
>" suffix. These will need to
|
|
be renamed to a "<TT
|
|
CLASS="FILENAME"
|
|
>.gml</TT
|
|
>" ending. You can do this manually, or you can download and use the file below, made by this
|
|
author, which contains the files of both <TT
|
|
CLASS="FILENAME"
|
|
>ISOEnts.zip</TT
|
|
> and <TT
|
|
CLASS="FILENAME"
|
|
>isoENT-tar.gz</TT
|
|
>:
|
|
</P
|
|
><P
|
|
> <A
|
|
HREF="http://reaster.com/iso8879-entities.tar.gz"
|
|
TARGET="_top"
|
|
>http://reaster.com/iso8879-entities.tar.gz</A
|
|
>
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN181"
|
|
>2.4. DocBook DSSSL</A
|
|
></H2
|
|
><P
|
|
> <A
|
|
HREF="http://www.nwalsh.com/"
|
|
TARGET="_top"
|
|
>Norman Walsh</A
|
|
>'s Document Style Semantics and Specification
|
|
Language (DSSSL) files for the DocBook DTD (SGML/XML) are maintained at the
|
|
<A
|
|
HREF="http://docbook.sourceforge.net/"
|
|
TARGET="_top"
|
|
>DocBook Open Repository</A
|
|
>
|
|
at <A
|
|
HREF="http://www.sourceforge.net/"
|
|
TARGET="_top"
|
|
>SourceForge</A
|
|
>.
|
|
These files, also known as the <A
|
|
HREF="http://docbook.sourceforge.net/projects/dsssl/doc/"
|
|
TARGET="_top"
|
|
>Modular DocBook Stylesheets</A
|
|
>,
|
|
tell <TT
|
|
CLASS="FILENAME"
|
|
>openjade</TT
|
|
> what
|
|
to do when converting your DocBook SGML file into other formats. A dsl file specifies things such as the
|
|
mappings from one DTD's tags to another DTD's tags and other programmatic conversions, programmed in the
|
|
<A
|
|
HREF="http://www.cs.berkeley.edu/~wilensky/CS294/dsssl/html/index.htm"
|
|
TARGET="_top"
|
|
>DSSSL</A
|
|
> language. The DSSSL
|
|
language is decomposed into a group of different languages, but running through it all is the
|
|
<A
|
|
HREF="http://www.cs.berkeley.edu/~wilensky/CS294/dsssl/html/h2-15.htm"
|
|
TARGET="_top"
|
|
>Core Expression Language</A
|
|
>
|
|
which is based on <A
|
|
HREF="http://www.schemers.org/Documents/Standards/R5RS/HTML/"
|
|
TARGET="_top"
|
|
>Scheme</A
|
|
>.
|
|
</P
|
|
><P
|
|
> The DocBook DSSSL package and documentation can be downloaded from the
|
|
<A
|
|
HREF="http://docbook.sourceforge.net/projects/dsssl/"
|
|
TARGET="_top"
|
|
>DocBook DSSSL Stylesheets Project</A
|
|
>
|
|
</P
|
|
><P
|
|
> The <A
|
|
HREF="http://www.linuxdoc.org/"
|
|
TARGET="_top"
|
|
>Linux Documentation Project</A
|
|
> has a stylesheet
|
|
customization file that turns on some nice style features. It can be downloaded at:
|
|
</P
|
|
><P
|
|
> <A
|
|
HREF="http://www.linuxdoc.org/authors/tools/ldp.dsl"
|
|
TARGET="_top"
|
|
>http://www.linuxdoc.org/authors/tools/ldp.dsl</A
|
|
>
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN198"
|
|
>2.5. SGMLtools-Lite</A
|
|
></H2
|
|
><P
|
|
> SGMLtools-Lite is a frontend for openjade, <TT
|
|
CLASS="FILENAME"
|
|
>jadetex</TT
|
|
>, <TT
|
|
CLASS="FILENAME"
|
|
>pdfjadex</TT
|
|
>,
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>dvips</TT
|
|
>, and other programs. It
|
|
provides a single command for generating all the formats possible with these tools. The
|
|
lastest release can be downloaded at:
|
|
</P
|
|
><P
|
|
><A
|
|
HREF="http://sourceforge.net/projects/sgmltools-lite/"
|
|
TARGET="_top"
|
|
>http://sourceforge.net/projects/sgmltools-lite/</A
|
|
></P
|
|
><P
|
|
> This package is optional, but does make things easier sometimes.
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN207"
|
|
>2.6. HTMLdoc</A
|
|
></H2
|
|
><P
|
|
> HTMLdoc is a free program for converting websites into Portable Document Format (<TT
|
|
CLASS="FILENAME"
|
|
>pdf</TT
|
|
>)
|
|
or <SPAN
|
|
CLASS="PRODUCTNAME"
|
|
>PostScript</SPAN
|
|
> (<TT
|
|
CLASS="FILENAME"
|
|
>ps</TT
|
|
>). For <TT
|
|
CLASS="FILENAME"
|
|
>pdf</TT
|
|
>, it creates
|
|
a tree of bookmarks that make navigation easy.
|
|
Both <B
|
|
CLASS="COMMAND"
|
|
>htmldoc</B
|
|
> and <B
|
|
CLASS="COMMAND"
|
|
>pdfjadetex</B
|
|
> output <TT
|
|
CLASS="FILENAME"
|
|
>pdf</TT
|
|
> files,
|
|
but in slightly different formats. Try both and see which turns out best for a particular docbook file. See quick links
|
|
below for download site.
|
|
</P
|
|
><P
|
|
> You can download the lastest version of <SPAN
|
|
CLASS="PRODUCTNAME"
|
|
>HTMLdoc</SPAN
|
|
>
|
|
from <A
|
|
HREF="http://www.easysw.com/"
|
|
TARGET="_top"
|
|
>Easy Software Products</A
|
|
>'
|
|
<A
|
|
HREF="ftp://ftp.easysw.com/pub/htmldoc/"
|
|
TARGET="_top"
|
|
>ftp site</A
|
|
>.
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN221"
|
|
>2.7. DocBook2X</A
|
|
></H2
|
|
><P
|
|
> DocBook2X requires perl5 and the SGMLS.pm perl module, available at the Comprehensive
|
|
Perl Archive Network (CPAN). SGMLS.pm provides libraries and a program
|
|
called <TT
|
|
CLASS="FILENAME"
|
|
>sgmlspl</TT
|
|
> which translates DocBook files into other
|
|
formats by using specification files. The specification files are perl files that
|
|
provide the logic for the translation to a particular format.
|
|
</P
|
|
><P
|
|
><A
|
|
HREF="http://www.cpan.org/"
|
|
TARGET="_top"
|
|
>http://www.cpan.org/</A
|
|
></P
|
|
><P
|
|
><A
|
|
HREF="http://docbook2x.sourceforge.net/"
|
|
TARGET="_top"
|
|
>http://docbook2x.sourceforge.net/</A
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="intro.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="install.html"
|
|
>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"
|
|
>Install the Packages</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |