<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 >