This commit is contained in:
gferg 2003-06-18 13:14:13 +00:00
parent cb6c0afb7c
commit d9fd3a6ae5
1 changed files with 18 additions and 8 deletions

View File

@ -1,7 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://docbook.org/xml/4.1.2/docbookx.dtd" []>
<article>
@ -23,6 +22,17 @@
<revhistory>
<revision>
<revnumber>v2.2.6</revnumber>
<date>2003-06-16</date>
<authorinitials>sa</authorinitials>
<revremark>
Verified the instruction against docbook XSL 1.57.
</revremark>
</revision>
<revision>
<revnumber>v2.2.5</revnumber>
<date>2003-05-16</date>
@ -341,7 +351,7 @@ LDP DSL is a customized style sheet used by <ulink url="http://www.tldp.org">The
<para>Please download the package called docbook-xsl.</para>
<note><title>Note</title>
<para>Recently docbook-xsl ver. 1.57.0 was released. This document has not been tested with 1.5.7. But there should not be any issues. If you run into any issue with docbook-xsl and this document, please email me @ <email>saqib@seagate.com</email></para>
<para>Recently docbook-xsl ver. 1.57.0 was released. This document is verified with the latest version, and appropriate modifications have been made. If you still encounter any errors please email me @ <email>saqib@seagate.com</email></para>
</note>
</sect2>
@ -729,7 +739,7 @@ To convert from SGML to RTF, use the following command:
</sect2>
<sect2><title>Processing XML</title>
<para> You can download a sample DocBook 4.1.2 XML file from <ulink url="http://www.seagate.cc:8080/cocoon/mount/docbook/openjade.xml">http://www.seagate.cc:8080/cocoon/mount/docbook/openjade.xml</ulink></para>
<para> You can download a sample DocBook 4.1.2 XML file from <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml">http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml</ulink></para>
<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 for the Bourne shell:</para>
@ -794,7 +804,7 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<para>Using an application server like Cocoon is the best the option.</para>
<note><title>Cocoon in Action</title>
<para>To see an example of web server running Tomcat + Cocoon serving DocBook 4.1.2 XML content, please visit <ulink url="http://www.seagate.cc:8080/cocoon/mount/docbook/">http://www.seagate.cc:8080/cocoon/mount/docbook/</ulink></para>
<para>To see an example of web server running Tomcat + Cocoon serving DocBook 4.1.2 XML content, please visit <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/">http://www.xml-dev.com:8080/cocoon/mount/docbook/</ulink></para>
</note>
<para> In this section we will see how to serve DocBook 4.1.2 XML content using Tomcat + Cocoon.</para>
@ -905,7 +915,7 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<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> directory.</para>
<para>A sample file is available from <ulink url="http://www.seagate.cc:8080/cocoon/mount/docbook/openjade.xml">http://www.seagate.cc:8080/cocoon/mount/docbook/openjade.xml</ulink>.</para>
<para>A sample file is available from <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml">http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml</ulink>.</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>
@ -949,7 +959,7 @@ 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://www.seagate.cc/blog/">http://www.seagate.cc/blog/</ulink> XML / XHTML WebLog</para></listitem>
<listitem><para><ulink url="http://www.xml-dev.com/blog/">http://www.xml-dev.com/blog/</ulink> XML / XHTML WebLog</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>
@ -957,13 +967,13 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
<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>
<listitem><para><ulink url="http://www.seagate.cc:8080/cocoon/mount/docbook/">http://www.seagate.cc:8080/cocoon/mount/docbook/</ulink>Tomcat + Cocoon + DocBook Setup Sample Site</para></listitem>
<listitem><para><ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/">http://www.xml-dev.com:8080/cocoon/mount/docbook/</ulink>Tomcat + Cocoon + DocBook Setup Sample Site</para></listitem>
</orderedlist>
</sect2>
<sect2><title>XML Authoring / Modeling Applications</title>
<note><title>Note</title>
<para> <emphasis role="strong">A comprehensive list of XML editors can be found at <ulink url="http://www.seagate.cc/blog/#19">http://www.seagate.cc/blog/#19</ulink></emphasis></para>
<para> <emphasis role="strong">A comprehensive list of XML editors can be found at <ulink url="http://www.xml-dev.com/blog/#19">http://www.xml-dev.com/blog/#19</ulink></emphasis></para>
</note>
<orderedlist>
<listitem><para>eXchaNGeR - The XML Browser (and XML Editor)<ulink url="http://xngr.org/">http://xngr.org/</ulink></para></listitem>