LDP
/
LDP
mirror of https://github.com/tLDP/LDP
0
1
Fork 0
Code Releases Activity

updated

This commit is contained in:
gferg 2002-09-30 15:35:50 +00:00
parent e8ae28ac70
commit 9a1614e338
1 changed files with 121 additions and 94 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

215
LDP/howto/docbook/DocBook-OpenJade-SGML-XML-HOWTO.xml
View File

@ -1,6 +1,4 @@
<?xml version='1.0' encoding='ISO-8859-1'?>
<!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook XML V4.1.2//EN'>
<?xml version="1.0" encoding="UTF-8"?>
<article>
@ -18,14 +16,35 @@
</affiliation>
</author>
<revhistory>
<revision>
<revnumber>v2.2</revnumber>
<date>2002-09-29</date>
<authorinitials>as</authorinitials>
<revremark>
Minor corrections to the Cocoon section.
</revremark>
</revision>
<revision>
<revnumber>v2.1</revnumber>
<date>2002-09-15</date>
<authorinitials>sa</authorinitials>
<revremark>
Minor corrections to the Cocoon section.
</revremark>
</revision>
<revision>
<revnumber>v2.0</revnumber>
<date>2002-09-10</date>
<authorinitials>sa</authorinitials>
<revremark>
Added the section on serving DocBook XML 4.1.2 content using Tomcat+Cocoon
Added the section on serving DocBook XML 4.1.2 content using Tomcat + Cocoon.
</revremark>
</revision>
@ -44,7 +63,7 @@
<date>2002-08-08</date>
<authorinitials>sa</authorinitials>
<revremark>
Many valuable modifications/corrections suggested by Lloyd D Budd. Thanks Lloyd :)
Many valuable modifications/corrections suggested by Lloyd D Budd. Thanks Lloyd. :)
</revremark>
</revision>
@ -54,7 +73,7 @@
<date>2002-08-02</date>
<authorinitials>sa</authorinitials>
<revremark>
Added the "Additional Reseources" section.
Added the "Additional Resources" section.
</revremark>
</revision>
@ -64,15 +83,17 @@
<date>2002-07-23</date>
<authorinitials>sa</authorinitials>
<revremark>
Added the section on converting HTML -> PDF using HTMLDOC. Thanks to Luc De Louw for the suggestion.
Added the section on converting HTML -&gt; PDF using HTMLDOC. Thanks to Luc De Louw for the suggestion.
</revremark>
</revision>
<revision>
<revnumber>v1.1</revnumber>
<date><2002-07-19</date>
<date>2002-07-19</date>
<authorinitials>KET</authorinitials>
<revremark>fixed grammatical errors, numbered processes</revremark>
<revremark>
Fixed grammatical errors, numbered processes.
</revremark>
</revision>
<revision>
@ -116,19 +137,20 @@ the GNU Free Documentation License, Version 1.1 or any later version
published by the Free Software Foundation; with no Invariant
Sections, with no Front-Cover Texts, and with no Back-Cover Texts.
A copy of the license is available at
<ulink url="http://www.gnu.org/copyleft/fdl.html">http://www.gnu.org/copyleft/fdl.html</ulink>
<ulink url="http://www.gnu.org/copyleft/fdl.html">http://www.gnu.org/copyleft/fdl.html</ulink>.
</para>
</sect2>
<sect2><title>Credits</title>
<para>All praise is due to <emphasis role="strong">Allah</emphasis>, <emphasis role="strong">The Lord of the Worlds</emphasis>. All credits go to <emphasis role="strong">Allah</emphasis>. Any mistake in this document is my own fault.</para>
<para>Additionally, I would like to acknowledge following people for their valuable contributions to this document:</para>
<para>Additionally, I would like to acknowledge the following people for their valuable contributions to this document:</para>
<orderedlist>
<listitem><para>Greg Ferguson <email>gferg (at) hoop.timonium.sgi.com</email> - for very helpful hints/suggestions on the docbook mailing list</para></listitem>
<listitem><para>Kristin Thomas <email>kristint (at) us.ibm.com</email> - For the initial review of this document.</para></listitem>
<listitem><para>Luc de Louw <email>luc@delouw.ch</email> - For suggestions on HTMLDOC (PDF -> HTML) section</para></listitem>
<listitem><para>Lloyd D Budd <email>ldp@foolswisdom.org</email> - For suggestions on improving most of the sections of the document</para></listitem>
<listitem><para>Luc de Louw <email>luc@delouw.ch</email> - For suggesting the HTMLDOC (PDF -&gt; HTML) section.</para></listitem>
<listitem><para>Lloyd D Budd <email>ldp@foolswisdom.org</email> - For suggestions on improving most of the sections of the document.</para></listitem>
<listitem><para>Andrew Shugg <email>andrew@neep.com.au</email> - For fixing errors in the ver 2.0 of this document.</para></listitem>
</orderedlist>
</sect2>
@ -142,30 +164,31 @@ completeness.
</para>
<para>
A DTD defines the syntax of a document - essentially it is a 'rule book' that describes the sets of tags and attributes that will be used to describe specific kinds of content. So DocBook is a "Rule Book" that is used for writing documents. Every TAG that is used in writing the document, must be defined verfy specifically and formally in the DTD.
A DTD defines the syntax of a document - essentially it is a 'rule book' that describes the sets of tags and attributes that will be used to describe specific kinds of content. So DocBook is a "rule book" that is used for writing documents. Every tag that is used in writing the document, must be defined very specifically and formally in the DTD.
</para>
</sect2>
<sect2><title>What is DSSSL?</title>
<para>A Document Style Semantics and Specification Language (DSSSL)
defines how to convert an Standard Generalized Markup Language (SGML) document into a human-readable format.</para>
defines how to convert an Standard Generalized Markup Language (SGML) document into a human-readable viewing format such as HTML, RTF and PDF.</para>
</sect2>
<sect2><title>What do we need?</title>
<para>The tools needed to set up OpenJade for converting SGML and XML are: </para>
<para>The tools needed to set up OpenJade for converting SGML and XML are: </para>
<itemizedlist>
<listitem><para>OpenJade</para></listitem>
<listitem><para>Entities</para></listitem>
<listitem><para>Norman Walsh's DSSSL</para></listitem>
<listitem><para>DocBook DTDs</para></listitem>
<listitem><para>ISO Entities</para></listitem>
<listitem><para>Norman Walsh's DSSSL</para></listitem>
<listitem><para>LDP DSL</para></listitem>
<listitem><para>Norman Walsh's XSL</para></listitem>
<listitem><para>LDP XSL</para></listitem>
<listitem><para>HTMLDOC (optional)</para></listitem>
<listitem><para>Norman Walsh's XSL (optional)</para></listitem>
<listitem><para>LDP XSL (optional)</para></listitem>
</itemizedlist>
@ -179,11 +202,13 @@ defines how to convert an Standard Generalized Markup Language (SGML) document i
<sect2><title>Assumptions</title>
<para> This document assumes that you have the following already
installed on your system. </para>
installed on your system. </para>
<itemizedlist>
<listitem><para>gzip - available from <ulink url="http://www.gnu.org">http://www.gnu.org</ulink></para></listitem>
<listitem><para>gcc and GNU make - available from <ulink url="http://www.gnu.org">http://www.gnu.org</ulink></para></listitem>
<listitem><para>gzip - available from <ulink url="http://www.gnu.org/directory/">http://www.gnu.org/directory/</ulink></para></listitem>
<listitem><para>gcc and GNU make - available from <ulink url="http://www.gnu.org/directory/">http://www.gnu.org/directory/</ulink></para></listitem>
<listitem><para>unzip - available from <ulink url="http://www.info-zip.org/pub/infozip/">http://www.info-zip.org/pub/infozip/</ulink></para></listitem>
<listitem><para>Standard Unix utilities - tar, mkdir, mv ...</para></listitem>
</itemizedlist>
</sect2>
@ -195,7 +220,7 @@ installed on your system. </para>
<para>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.
</para>
<para>Most of the packages that we need, are located at <ulink url="http://www.tldp.org/authors/index.html#resources">The Linux Documentation Project (TLDP)</ulink> website</para>
<para>Most of the packages that we need are located at <ulink url="http://www.tldp.org/authors/index.html#resources">The Linux Documentation Project (TLDP)</ulink> website.</para>
<sect2><title>Pre-requirements</title>
@ -209,14 +234,14 @@ Create a directory <filename class="directory">/tmp/downloads</filename>. We wil
<ulink url="http://openjade.sourceforge.net/">http://openjade.sourceforge.net/</ulink>.
</para>
<para>At the time of writing this document OpenJade 1.3.1 was available. Download the openjade-1.3.x.tar.gz file</para>
<para>At the time of writing this document OpenJade 1.3.1 was available. Download the openjade-1.3.x.tar.gz file.</para>
</sect2>
<sect2><title>DocBook DTD</title>
<sect2><title>DocBook DTDs</title>
<para>All the DocBook DTDs are available from The Linux Documentation Project website at <ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink></para>
<para>Please download <ulink url="http://www.tldp.org/authors/tools/docbk41.zip">DocBook SGML v4.1</ulink>, <ulink url="http://www.tldp.org/authors/tools/docbk31.zip">DocBook SGML v3.1</ulink>, and <ulink url="http://www.tldp.org/authors/tools/docbkx412.zip">DocBook XML v4.1.2</ulink>
<para>Please download <ulink url="http://www.tldp.org/authors/tools/docbk41.zip">DocBook SGML v4.1</ulink>, <ulink url="http://www.tldp.org/authors/tools/docbk31.zip">DocBook SGML v3.1</ulink>, and <ulink url="http://www.tldp.org/authors/tools/docbkx412.zip">DocBook XML v4.1.2</ulink>.
</para>
<note><title>Note</title>
@ -255,10 +280,10 @@ LDP DSL is a customized style sheet used by <ulink url="http://www.tldp.org">The
</sect2>
<sect2><title>Norman Walsh's XSL (Optional)</title>
<para>This is not necessary. But if you would like to server DocBook 4.1.2 XML content using Tomcat+Cocoon, you will need Normal Walsh's XML Style Sheets</para>
<para>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.</para>
<para>The Style Sheeets are availabel for download at <ulink url="http://sourceforge.net/projects/docbook/">http://sourceforge.net/projects/docbook/</ulink></para>
<para>Please download the package called docbook-xsl</para>
<para>The Style Sheets are available for download at <ulink url="http://sourceforge.net/projects/docbook/">http://sourceforge.net/projects/docbook/</ulink>.</para>
<para>Please download the package called docbook-xsl.</para>
</sect2>
@ -272,22 +297,20 @@ LDP DSL is a customized style sheet used by <ulink url="http://www.tldp.org">The
<sect1 id="inst-openjade"> <title>Installing Processing Tools - OpenJade</title>
<para>In this section we will install all the tools in the appropriate
directories. All the tools go in the <filename
class="directory">/usr/local/dbtools/</filename> directory. Create
directories. All the tools go in the <filename class="directory">/usr/local/dbtools/</filename> directory. Create
this directory using the following command:</para>
<screen>
<command>mkdir /usr/local/dbtools</command>
<command># mkdir /usr/local/dbtools</command>
</screen>
<sect2><title>Installing OpenJade</title>
<para>This process is a 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:</para>
<orderedlist>
<listitem>
<para>Change directories to <filename
class="directory">/tmp/downloads</filename>.
<para>Change directories to <filename class="directory">/tmp/downloads</filename>.
</para>
<screen>
<command># cd /tmp/downloads</command>
@ -335,8 +358,7 @@ install OpenJade complete the following steps:</para>
</listitem>
<listitem>
<para>Copy the <filename class="directory">dsssl</filename>
directory from <filename
class="directory">/tmp/downloads/openjade-1.3.x to
directory from <filename class="directory">/tmp/downloads/openjade-1.3.x to
/usr/local/dbtools/openjade</filename>
</para>
<screen>
@ -374,8 +396,7 @@ place. The DSSSL does not have to be compiled.
</screen>
</listitem>
<listitem>
<para>Move the file to the <filename
class="directory">/usr/local/dbtools/docbook-dsssl</filename>.</para>
<para>Move the file to the <filename class="directory">/usr/local/dbtools/docbook-dsssl</filename>.</para>
<screen>
<command># mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl</command>
</screen>
@ -397,7 +418,7 @@ place. The DSSSL does not have to be compiled.
</screen>
</listitem>
<listitem>
<para>Create a new directory called <filename class="directory">dtd3.1</filename> <filename class="directory">dtd4.1</filename> <filename class="directory">dtd4.1.2</filename>.</para>
<para>Create three new directories called <filename class="directory">dtd3.1</filename>, <filename class="directory">dtd4.1</filename>, and <filename class="directory">dtd4.1.2</filename>.</para>
<screen>
<command># mkdir dtd3.1</command>
<command># mkdir dtd4.1</command>
@ -452,12 +473,11 @@ place. The DSSSL does not have to be compiled.
<para>In this section we will install the ISO entities that we downloaded from the LDP website.</para>
<para>First we install the ISO Entities for the 3.1 SMGL DTD</para>
<para>First we install the ISO Entities for the 3.1 SGML DTD.</para>
<orderedlist>
<listitem>
<para>Change directories to the <filename
class="directory">/usr/local/dbtools/dtd3.1</filename> directory.</para>
<para>Change directories to the <filename class="directory">/usr/local/dbtools/dtd3.1</filename> directory.</para>
<screen>
<command># cd /usr/local/dbtools/dtd3.1</command>
</screen>
@ -483,12 +503,11 @@ place. The DSSSL does not have to be compiled.
</listitem>
</orderedlist>
<para>Next we install the ISO Entities for the 4.1 SMGL DTD</para>
<para>Next we install the ISO Entities for the 4.1 SGML DTD.</para>
<orderedlist>
<listitem>
<para>Change directories to the <filename
class="directory">/usr/local/dbtools/dtd4.1</filename> directory.</para>
<para>Change directories to the <filename class="directory">/usr/local/dbtools/dtd4.1</filename> directory.</para>
<screen>
<command># cd /usr/local/dbtools/dtd4.1</command>
</screen>
@ -517,13 +536,12 @@ place. The DSSSL does not have to be compiled.
</sect2>
<sect2><title>Installing LDP DSL</title>
<para>Finally we install the ldp.dsl.</para>
<sect2><title>Installing the LDP DSL</title>
<para>Finally we install the customised LDP stylesheet.</para>
<orderedlist>
<listitem>
<para>Change directories to the <filename
class="directory">/tmp/download</filename> directory.</para>
<para>Change directories to the <filename class="directory">/tmp/download</filename> directory.</para>
<screen>
<command># cd /tmp/download </command>
</screen>
@ -535,7 +553,7 @@ place. The DSSSL does not have to be compiled.
</screen>
</listitem>
<listitem>
<para>>Copy the <filename>ldp.dsl</filename> file to the
<para>Copy the <filename>ldp.dsl</filename> file to the
<filename class="directory">
/usr/local/dbtools/docbook-dsssl/html/ldp.dsl</filename>
directory.</para>
@ -548,26 +566,26 @@ directory.</para>
</sect2>
<sect2><title>Installing HTMLDOC</title>
<para>This step is optional. It is only required if you want to produce PDF documents</para>
<para>Change back to the downloads directory</para>
<para>This step is optional. It is only required if you want to produce PDF documents from HTML.</para>
<para>Change back to the downloads directory.</para>
<screen>
<command># Change to /tmp/download directory</command>
</screen>
<para>Untar the source code for HTMLDOC</para>
<para>Untar the source code for HTMLDOC.</para>
<screen>
<command># gzip -d htmldoc-1.8.xx-source.tar.gz </command>
<command># tar -xvf htmldoc-1.8.xx-source.tar </command>
<command># cd htmldoc-1.8.xx-1</command>
</screen>
<para>run configure to set the installation location</para>
<para>Run configure to set the installation location.</para>
<screen>
<command># ./configure --prefix=/usr/local/dbtools/htmldoc</command>
<command># make</command>
</screen>
<para>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</para>
<para>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.</para>
<para>Here is the error you will get while running <command>make install</command></para>
<para>Here is the error you will get while running <command>make install</command>:</para>
<screen>
<command># make install</command>
Making all in htmldoc...
@ -581,7 +599,7 @@ Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
make[1]: *** [install] Error 1
</screen>
<para> To fix this installation issue, please edit <filename>fonts/Makefile</filename> and comment out the lines with references to ZapfChancery and ZapfDingbats fonts</para>
<para> To fix this installation issue, please edit <filename>fonts/Makefile</filename> and comment out the lines with references to ZapfChancery and ZapfDingbats fonts.</para>
<para>Then execute the install:</para>
<screen>
@ -608,16 +626,20 @@ Installing in htmldoc...
<sect1><title>Using OpenJade</title>
<para>In this section we will use OpenJade to convert SGML/XML documents to HTML, RTF, and PDF.</para>
<para>In this section we will use OpenJade to convert DocBook SGML/XML documents to HTML, RTF, and PDF.</para>
<sect2><title>Processing SGML</title>
<para> You can download a sample DocBook 3.1 SGML file from <ulink url="http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.sgml">http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.sgml</ulink></para>
<sect3><title>Setting the SGML_CATALOG_FILES Environmental Variable for SGML</title>
<para>The SGML_CATALOG_FILES variable must be set to point to appropriate catalog files. To set the variable, use the following command:</para>
<para>The SGML_CATALOG_FILES variable must be set to point to appropriate catalog files. To set the variable, use the following command for the Bourne shell:</para>
<screen>
<command># export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
<para>Use the following command for the C shell:</para>
<screen>
<command># setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
</sect3>
<sect3><title>SGML to HTML</title>
@ -653,17 +675,20 @@ To convert from SGML to RTF, use the following command:
<sect3><title>Setting the SGML_CATALOG_FILES Environmental Variable for XML</title>
<para>The SGML_CATALOG_FILES variable must be set to point to appropriate
catalog files. To set the variable, use the following command:</para>
catalog files. To set the variable, use the following command for the Bourne shell:</para>
<screen>
<command># export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
<para>Use the following command for the C shell:</para>
<screen>
<command># setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
</sect3>
<sect3><title>XML to HTML</title>
<para>
To convert from XML to HTML, use the following command</para>
To convert from XML to HTML, use the following command:</para>
<screen>
<command># /usr/local/dbtools/openjade/bin/openjade -t xml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html /usr/local/dbtools/docbook-dsssl/dtds/decls/xml.dcl DocBook-OpenJade-SGML-XML-HOWTO.xml</command>
@ -673,7 +698,7 @@ To convert from XML to HTML, use the following command</para>
<sect3><title>XML to RTF</title>
<para>
To convert from XML to HTML, use the following command</para>
To convert from XML to HTML, use the following command:</para>
<screen>
<command># /usr/local/dbtools/openjade/bin/openjade -t rtf -d /usr/local/dbtools/docbook-dsssl/print/ldp.dsl#print /usr/local/dbtools/docbook-dsssl/dtds/decls/xml.dcl DocBook-OpenJade-SGML-XML-HOWTO.xml</command>
@ -691,7 +716,7 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<command># /usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml </command>
</screen>
<para>Then run HTMLDOC to produce PDF</para>
<para>Then run HTMLDOC to produce PDF.</para>
<screen>
<command># /usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html</command>
</screen>
@ -701,22 +726,22 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
</sect1>
<sect1><title>Serving DocBook 4.1.2 XML</title>
<para>There are 3 ways to server DocBook 4.1.2 XML from a web server</para>
<para>There are 3 ways to server DocBook 4.1.2 XML from a web server:</para>
<itemizedlist>
<listitem><para>Command line Pre-processed Open Jade, XSLT</para></listitem>
<listitem><para>Scripting - PHP, Perl, Python</para></listitem>
<listitem><para>Application server - Cocoon</para></listitem>
<listitem><para>Application server - Tomcat + Cocoon</para></listitem>
</itemizedlist>
<para>Using a Application server like Cocoon is the best the option. In this section we will see how to serve DocBook 4.1.2 XML content using Cocoon+Tomcat</para>
<para>Using an application server like Cocoon is the best the option. In this section we will see how to serve DocBook 4.1.2 XML content using Tomcat + Cocoon.</para>
<sect2><title>Tomcat + Cocoon</title>
<para>Tomcat is the Java Servlet Container. For more information please visit <ulink url="http://jakarta.apache.org/tomcat/index.html">http://jakarta.apache.org/tomcat/index.html</ulink></para>
<para>Apache Cocoon is an XML publishing framework. For more information please visit <ulink url="http://xml.apache.org/cocoon/index.html">http://xml.apache.org/cocoon/index.html</ulink></para>
<para>Tomcat is the Java Servlet Container. For more information please visit <ulink url="http://jakarta.apache.org/tomcat/index.html">http://jakarta.apache.org/tomcat/index.html</ulink>.</para>
<para>Apache Cocoon is an XML publishing framework. For more information please visit <ulink url="http://xml.apache.org/cocoon/index.html">http://xml.apache.org/cocoon/index.html</ulink>.</para>
<para>This HOWTO will not go into details of setting up Cocoon+Tomcat, since it is already explained @ <ulink url="http://xml.apache.org/cocoon/installing/index.html">http://xml.apache.org/cocoon/installing/index.html</ulink>. Setting up Tomcat+Cocoon is a easy process and should take less than 5 mins.</para>
<para>This HOWTO will not go into details of setting up Tomcat + Cocoon, since it is already explained in the document <ulink url="http://xml.apache.org/cocoon/installing/index.html">http://xml.apache.org/cocoon/installing/index.html</ulink>. Setting up Tomcat + Cocoon is an easy process and should take less than five minutes.</para>
<para>Once you have the Cocoon + Tomcat setup and working, please follow the next the sections to server DocBook 4.1.2 XML content.</para>
</sect2>
@ -727,10 +752,10 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<screen><command># gzip -d docbook-xsl-1.53.0.tar.gz</command></screen>
<screen><command># tar -xvf docbook-xsl-1.53.0.tar</command></screen>
<para>To install the docbook-xsl please move the files to the <filename class="directory">/usr/local/dbtools</filename></para>
<para>To install the docbook-xsl please move the files to the <filename class="directory">/usr/local/dbtools</filename>.</para>
<screen><command># mv docbook-xsl-1.53.0 /usr/local/dbtool/docbook-xsl</command></screen>
<para>Next install the LDP XSL</para>
<para>Next install the LDP XSL.</para>
</sect2>
<sect2><title>Installing LDP XSL</title>
@ -740,7 +765,7 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<screen><command># unzip ldp-xs.zip</command></screen>
<screen><command># mv ldp-html*.xsl /usr/local/dbtools/docbook-xsl/html</command></screen>
<para>Next edit the <filename>/usr/local/dbtools/docbook-xsl/html/ldp-html.xsl</filename> to set the path for the import file</para>
<para>Next edit the <filename>/usr/local/dbtools/docbook-xsl/html/ldp-html.xsl</filename> to set the path for the import file.</para>
<screen><command># vi /usr/local/dbtools/docbook-xsl/html/ldp-html.xsl</command></screen>
@ -752,12 +777,12 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
</sect2>
<sect2><title>Setting up sitemap.xmap</title>
<para>$COCOON_HOME points to the Cocoon Web Application Directory. This direcotry is typically <filename class="directory">/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/</filename></para>
<para>$COCOON_HOME points to the Cocoon Web Application Directory. This directory is typically <filename class="directory">/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/</filename></para>
<para>Create a directory named <filename class="directory">docbook</filename> under the <filename class="directory">$COCOON_HOME/mount</filename>. This is where we will put all out DocBook XML 4.1.2 content.</para>
<para>Create a directory named <filename class="directory">docbook</filename> under the <filename class="directory">$COCOON_HOME/mount</filename>. This is where we will put all our DocBook XML 4.1.2 content.</para>
<screen><command># mkdir $COCOON_HOME/mount/docbook</command></screen>
<para>Create a file name sitemap.xmap in the <filename class="directory">$COCOON_HOME/mount/docbook</filename> with the following content.</para>
<para>Create a file name sitemap.xmap in the <filename class="directory">$COCOON_HOME/mount/docbook</filename> with the following content:</para>
<screen><command># cd $COCOON_HOME/mount/docbook</command></screen>
<screen><command># vi sitemap.xmap</command></screen>
@ -816,11 +841,11 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
</sect2>
<sect2><title>Accessing DocBook 4.1.2 XML Content from a Web Browser</title>
<para>Place a DocBook 4.1.2 XML file in the <filename class="directory">$COCOON_HOME/mount/docbook/</filename></para>
<para>Place a DocBook 4.1.2 XML file in the <filename class="directory">$COCOON_HOME/mount/docbook/</filename> directory.</para>
<para>A sample file is availble from <ulink url="http://docbook.sc-icc.org/sample.xml">http://docbook.sc-icc.org/sample.xml</ulink></para>
<para>A sample file is availble from <ulink url="http://docbook.sc-icc.org/sample.xml">http://docbook.sc-icc.org/sample.xml</ulink>.</para>
<para>Now you can access the document using a browser @ http://localhost:8080/cocoon/mount/sample.html (HTML) or http://localhost:8080/cocoon/mount/sample.pdf (PDF)</para>
<para>Now you can access the document using a browser at http://localhost:8080/cocoon/mount/sample.html (HTML) or http://localhost:8080/cocoon/mount/sample.pdf (PDF).</para>
</sect2>
@ -829,21 +854,21 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
</sect1>
<sect1><title>Further Information</title>
<para>This section has some pointers to the related resource on the internet.</para>
<para> If you would like to suggest additional resource for this section, please email me @ <email> saqib@seagate.com</email>. Thanks. </para>
<para>This section has some pointers to related resources on the Internet.</para>
<para> If you would like to suggest additional resource for this section, please email me at <email> saqib@seagate.com</email>. Thanks. </para>
<sect2><title>News groups</title>
<para>Some of the News groups of interest are:</para>
<para>Some of the news groups of interest are:</para>
<orderedlist>
<listitem><para>comp.text.sgml (easily accessible from <ulink url="http://www.deja.com">http://www.deja.com</ulink>)</para></listitem>
<listitem><para>comp.text.xml (easily accessible from <ulink url="http://www.deja.com">http://www.deja.com</ulink>)</para></listitem>
<listitem><para>comp.text.sgml (easily accessible from <ulink url="http://groups.google.com/">http://groups.google.com/</ulink>)</para></listitem>
<listitem><para>comp.text.xml (easily accessible from <ulink url="http://groups.google.com/">http://groups.google.com/</ulink>)</para></listitem>
<listitem><para>htmldoc.general (server - nttp://news.easysw.com)</para></listitem>
</orderedlist>
</sect2>
<sect2><title>Mailing Lists</title>
<para>Here are some relevant Mailing Lists</para>
<para>Here are some relevant mailing lists.</para>
<orderedlist>
<listitem><para>DocBook mailing list @ OASIS. Visit <ulink url="http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml">http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml</ulink> for more info.</para></listitem>
<listitem><para>DocBook mailing list @ TLDP. Visit <ulink url="http://www.tldp.org/mailinfo.html">http://www.tldp.org/mailinfo.html</ulink> for more info.</para></listitem>
@ -862,11 +887,13 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<sect2><title>Web Sites</title>
<orderedlist>
<listitem><para><ulink url="http://www.oasis-open.org/">http://www.oasis-open.org/</ulink> OASIS maintains various DocBook DTDs</para></listitem>
<listitem><para><ulink url="http://docbook.org/wiki/moin.cgi/">http://docbook.org/wiki/moin.cgi/</ulink>The DocBook Wiki</para></listitem>
<listitem><para><ulink url="http://www.docbook.org/tdg/en/">http://www.docbook.org/tdg/en/</ulink>Online version of DocBook: The Definitive Guide</para></listitem>
<listitem><para><ulink url="http://www-106.ibm.com/developerworks/library/l-docbk.html">http://www-106.ibm.com/developerworks/library/l-docbk.html</ulink>A gentle guide to DocBook (very good introduction).</para></listitem>
<listitem><para><ulink url="http://www.tldp.org/LDP/LDP-Author-Guide/index.html">http://www.tldp.org/LDP/LDP-Author-Guide/index.html</ulink>The Linux Documentation Project (TLDP) Author Guide</para></listitem>
<listitem><para><ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink>DocBook resources provided by TLDP</para></listitem>
<listitem><para><ulink url="http://docbook.org/wiki/moin.cgi/">http://docbook.org/wiki/moin.cgi/</ulink> The DocBook Wiki</para></listitem>
<listitem><para><ulink url="http://www.docbook.org/tdg/en/">http://www.docbook.org/tdg/en/</ulink> Online version of DocBook: The Definitive Guide</para></listitem>
<listitem><para><ulink url="http://www.bureau-cornavin.com/opensource/crash-course/index.html">http://www.bureau-cornavin.com/opensource/crash-course/index.html</ulink> Writing Documentation Using DocBook: A Crash Course</para></listitem>
<listitem><para><ulink url="http://www-106.ibm.com/developerworks/library/l-docbk.html">http://www-106.ibm.com/developerworks/library/l-docbk.html</ulink> A gentle guide to DocBook (very good introduction).</para></listitem>
<listitem><para><ulink url="http://www.tldp.org/LDP/LDP-Author-Guide/index.html">http://www.tldp.org/LDP/LDP-Author-Guide/index.html</ulink> The Linux Documentation Project (TLDP) Author Guide</para></listitem>
<listitem><para><ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink> DocBook resources provided by TLDP</para></listitem>
<listitem><para><ulink url="http://www.tldp.org/HOWTO/DocBook-Demystification-HOWTO/">http://www.tldp.org/HOWTO/DocBook-Demystification-HOWTO/</ulink> Eric Raymond's DocBook Demystification HOWTO</para></listitem>
</orderedlist>
</sect2>
@ -874,7 +901,7 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<orderedlist>
<listitem><para>DocPro by Command Prompt, INC. <ulink url="http://www.commandprompt.com/entry.lxp?lxpe=2">http://www.commandprompt.com/entry.lxp?lxpe=2</ulink></para></listitem>
<listitem><para>YAWC Pro by XML Workshop LTD. <ulink url="http://www.yawcpro.com/">http://www.yawcpro.com/</ulink>. Can be used for converting MS Word to Simple DocBook XML. </para></listitem>
<listitem><para>Logictran RTF Converter. <ulink url="http://www.logictran.com/">http://www.logictran.com/</ulink>. Word/RTF to HTML/XML</para></listitem>
<listitem><para>Logictran RTF Converter. <ulink url="http://www.logictran.com/">http://www.logictran.com/</ulink>. Word/RTF to HTML/XML.</para></listitem>
<listitem><para>MajiX - Word to XML converter. <ulink url="http://tetrasys.dhs.org/">http://tetrasys.dhs.org/</ulink></para></listitem>
<listitem><para>XMETAL by SoftQuad <ulink url="http://www.softquad.com/">http://www.softquad.com/</ulink> </para></listitem>
</orderedlist>
@ -882,4 +909,4 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
</sect1>
</article>
</article>