<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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > <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" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Using OpenJade</TD ></TR ></TABLE ></DIV ></BODY ></HTML >