old-www/HOWTO/DocBook-OpenJade-SGML-XML-H.../inst-openjade.html

1204 lines
15 KiB
HTML

<HTML
><HEAD
><TITLE
>Installing Processing Tools - OpenJade</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="Requirements"
HREF="requirements.html"><LINK
REL="NEXT"
TITLE="Using OpenJade"
HREF="x456.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="requirements.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="x456.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="inst-openjade"
></A
>3. Installing Processing Tools - OpenJade</H1
><P
>In this section we will install all the tools in the appropriate directories. All the tools go in the <TT
CLASS="filename"
>/usr/local/dbtools/</TT
> directory. Create this directory using the following command:</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13;<B
CLASS="command"
># mkdir /usr/local/dbtools</B
>
</PRE
></FONT
></TD
></TR
></TABLE
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN256"
></A
>3.1. Installing OpenJade</H2
><P
>This process is the easy part, but the most time consuming one too. Keep in mind that OpenJade take a long time to compile. To install OpenJade, complete the following steps:</P
><P
></P
><OL
TYPE="1"
><LI
><P
>Change directories to <TT
CLASS="filename"
>/tmp/downloads</TT
>. </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd /tmp/downloads</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Unzip the file. </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># gzip -d openjade-1.3.x.tar.gz</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Untar the file.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># tar -xvf openjade-1.3.x.tar</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Change directories to <TT
CLASS="filename"
>openjade-1.3</TT
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd openjade-1.3.x</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Run the <B
CLASS="command"
>./configure</B
> command.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># ./configure --prefix=/usr/local/dbtools/openjade</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Run the <B
CLASS="command"
>make</B
> command.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># make</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Run the <B
CLASS="command"
>make install</B
> command. After this step the OpenJade binaries will be installed under <TT
CLASS="filename"
>/usr/local/dbtools/openjade</TT
>.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># make install</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Copy the <TT
CLASS="filename"
>dsssl</TT
> directory from <TT
CLASS="filename"
>/tmp/downloads/openjade-1.3.x to /usr/local/dbtools/openjade</TT
> </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cp -dpR dsssl /usr/local/dbtools/openjade/</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN300"
></A
>3.2. Installing Norman Walsh's DSSSL</H2
><P
> In this step we will install Norman Walsh's DSSSL in an appropriate place. The DSSSL does not have to be compiled. </P
><P
></P
><OL
TYPE="1"
><LI
><P
>Change directories to <TT
CLASS="filename"
>/tmp/downloads</TT
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd /tmp/downloads</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Unzip the file.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># gzip -d docbook-dsssl-1.76.tar.gz</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Untar the file.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># tar -xvf docbook-dsssl-1.76.tar</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Move the file to the <TT
CLASS="filename"
>/usr/local/dbtools/docbook-dsssl</TT
>.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN322"
></A
>3.3. Installing DocBook DTDs</H2
><P
>In this section we will install the DocBook DTDs. </P
><P
></P
><OL
TYPE="1"
><LI
><P
>Change directories to <TT
CLASS="filename"
>/usr/local/dbtools</TT
>.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd /usr/local/dbtools</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Create three new directories called <TT
CLASS="filename"
>dtd3.1</TT
>, <TT
CLASS="filename"
>dtd4.1</TT
>, and <TT
CLASS="filename"
>dtd4.1.2</TT
>.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># mkdir dtd3.1</B
>
<B
CLASS="command"
># mkdir dtd4.1</B
>
<B
CLASS="command"
># mkdir dtd4.1.2</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Change directories to the <TT
CLASS="filename"
>dtd3.1</TT
>.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd dtd3.1</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Unzip the file DocBook SGML v3.1 in this directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># unzip /tmp/downloads/docbk31.zip</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Change directories to the <TT
CLASS="filename"
>dtd4.1</TT
>.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd ../dtd4.1</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Unzip the file DocBook SGML v4.1 in this directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># unzip /tmp/downloads/docbk41.zip</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Change directories to the <TT
CLASS="filename"
>dtd4.1.2</TT
>.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd ../dtd4.1.2</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Unzip the file DocBook XML v4.1.2 in this directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># unzip /tmp/downloads/docbk412.zip</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN367"
></A
>3.4. Installing the ISO Entities</H2
><P
>In this section we will install the ISO entities that we downloaded from the LDP website.</P
><P
>First we install the ISO Entities for the 3.1 SGML DTD.</P
><P
></P
><OL
TYPE="1"
><LI
><P
>Change directories to the <TT
CLASS="filename"
>/usr/local/dbtools/dtd3.1</TT
> directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd /usr/local/dbtools/dtd3.1</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Copy <TT
CLASS="filename"
>/tmp/download/entities.tar.gz</TT
> to this directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cp /tmp/download/entities.tar.gz .</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Unzip the file.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># gzip -d entities.tar.gz</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Untar the file.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># tar -xvf entities.tar</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
><P
>Next we install the ISO Entities for the 4.1 SGML DTD.</P
><P
></P
><OL
TYPE="1"
><LI
><P
>Change directories to the <TT
CLASS="filename"
>/usr/local/dbtools/dtd4.1</TT
> directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd /usr/local/dbtools/dtd4.1</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Copy <TT
CLASS="filename"
>/tmp/download/entities.tar.gz</TT
> to this directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cp /tmp/download/entities.tar.gz .</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Unzip the file.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># gzip -d entities.tar.gz</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Untar the file.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># tar -xvf entities.tar</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN410"
></A
>3.5. Installing the LDP DSL</H2
><P
>Finally we install the customised LDP stylesheet.</P
><P
></P
><OL
TYPE="1"
><LI
><P
>Change directories to the <TT
CLASS="filename"
>/tmp/download</TT
> directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cd /tmp/download </B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Copy the <TT
CLASS="filename"
>ldp.dsl</TT
> file to the <TT
CLASS="filename"
> /usr/local/dbtools/docbook-dsssl/print/ldp.dsl</TT
> directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print/ldp.dsl</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>Copy the <TT
CLASS="filename"
>ldp.dsl</TT
> file to the <TT
CLASS="filename"
> /usr/local/dbtools/docbook-dsssl/html/ldp.dsl</TT
> directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html/ldp.dsl</B
>
</PRE
></FONT
></TD
></TR
></TABLE
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="AEN431"
></A
>3.6. Installing HTMLDOC</H2
><P
>This step is optional. It is only required if you want to produce PDF documents from HTML.</P
><P
>Change back to the downloads directory.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># Change to /tmp/download directory</B
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
>Untar the source code for HTMLDOC.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># gzip -d htmldoc-1.8.xx-source.tar.gz </B
>
<B
CLASS="command"
># tar -xvf htmldoc-1.8.xx-source.tar </B
>
<B
CLASS="command"
># cd htmldoc-1.8.xx-1</B
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
>Run configure to set the installation location.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># ./configure --prefix=/usr/local/dbtools/htmldoc</B
>
<B
CLASS="command"
># make</B
>
</PRE
></FONT
></TD
></TR
></TABLE
><P
>At the time of writing this document HTMLDOC ver 1.8.20-1 was available. This version had a little problem in the fonts Makefile. It would complain while installing the fonts, because the correct fonts were not available on the system.</P
><P
>Here is the error you will get while running <B
CLASS="command"
>make install</B
>:</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13; <B
CLASS="command"
># make install</B
>
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
/bin/cp: cannot stat `ZapfChancery.afm': No such file or directory
/bin/cp: cannot stat `ZapfChancery.pfa': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.afm': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.pfa': No such file or directory
make[1]: *** [install] Error 1
</PRE
></FONT
></TD
></TR
></TABLE
><P
> To fix this installation issue, please edit <TT
CLASS="filename"
>fonts/Makefile</TT
> and comment out the lines with references to ZapfChancery and ZapfDingbats fonts.</P
><P
>Then execute the install:</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="screen"
>&#13;<B
CLASS="command"
># make install</B
>
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
Installing in data...
Installing in doc...
Installing in htmldoc...
</PRE
></FONT
></TD
></TR
></TABLE
></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="requirements.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="x456.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Requirements</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Using OpenJade</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>