From 3a99c7ff82ae4d3f09cc64b38f4b43d78f9969b2 Mon Sep 17 00:00:00 2001
From: gferg <>
Date: Mon, 5 Aug 2002 21:41:53 +0000
Subject: [PATCH] updated
---
.../DocBook-OpenJade-SGML-XML-HOWTO.sgml | 1146 +++++++++--------
LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml | 2 +-
LDP/howto/docbook/HOWTO-INDEX/miscSect.sgml | 2 +-
3 files changed, 620 insertions(+), 530 deletions(-)
diff --git a/LDP/howto/docbook/DocBook-OpenJade-SGML-XML-HOWTO.sgml b/LDP/howto/docbook/DocBook-OpenJade-SGML-XML-HOWTO.sgml
index d04145bd..52012b36 100644
--- a/LDP/howto/docbook/DocBook-OpenJade-SGML-XML-HOWTO.sgml
+++ b/LDP/howto/docbook/DocBook-OpenJade-SGML-XML-HOWTO.sgml
@@ -1,528 +1,618 @@
-
-
-
-
-
-
- DocBook XML/SGML Processing Using OpenJade
-
-
- Saqib
- Ali
-
-
- saqib@seagate.com
-
-
-
-
-
-
-
- v1.2
- 2002-07-23
- sa
-
- Added the section on converting HTML -> PDF using HTMLDOC. Thanks to Luc De Louw for the suggestion.
-
-
-
-
- v1.1
- <2002-07-19
- KET
- fixed grammatical errors, numbered processes
-
-
-
- v1.0
- 2002-06-29
- sa
-
- Initial public release.
-
-
-
-
-
-
-
- This HOWTO explains setting up OpenJade to process SGML/XML DocBook documents.
-
-
-
-
-Introduction
-
- The objective of this document is to setup OpenJade to convert DocBook 3.2 and 4.2 (SGML/XML) documents to HTML, RTF, and PDF.
-
-
-
-Copyright and License
-
-This document is Copyright 2001 by Saqib Ali. Permission is granted
-to copy, distribute and/or modify this document under the terms of
-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
-http://www.gnu.org/copyleft/fdl.html
-
-
-
-What is DocBook?
-
-
-DocBook is document type definition (DTD). DocBook is a commonly used DTD for writing technical documents. A DTD defines the syntax of a document, so DocBook is a definition of a syntax for writing documents.
-
-
-
-
-What is DSSSL?
-A Document Style Semantics and Specification Language (DSSSL)
-defines how to convert an SGML document into a human-readable format.
-
-
-
-
-What do we need?
-
-The tools needed to set up OpenJade for converting SGML and XML are:
-
-
- OpenJade
- Entities
- Norman Walsh's DSSSL
- DocBook DTDs
- LDP DSL
-
-
-Note
- All of these packages are free and are available for
- download on the net. The next chapter explains how to download these packages.
-
-
-
-The only tool that you is compiled is OpenJade. The rest of the tools
-have to be extracted and placed in the right directories.
-
-
-
-
-Assumptions
-
- This document assumes that you have the following already
-installed on your system.
-
-
- gzip or gunzip - available from http://www.gnu.org
- gcc and GNU make - available from http://www.gnu.org
-
-
-
-
-
-
-
-Requirements
-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.
-
-
-Pre-requirements
-
-
-Create a directory /tmp/downloads. We will use this directory to store the downloaded source code.
-
-
-
-OpenJade
-OpenJade will be used to process DocBook documents. OpenJade can be downloaded from:
-http://openjade.sourceforge.net/.
-
-
-At the time of writing this document OpenJade 1.3.1 was available. Download the openjade-1.3.x.tar.gz file
-
-
-
-DocBook DTD
-All the DocBook DTDs are available from The Linux Documentation Project website at http://www.tldp.org/authors/index.html#resources
-
-I use DocBook 3.1, so we will work with 3.1 in this
-document. But you can download any or all of the DTDs.
-
-
-Note
- Please download the whole zip archive.
-
-
-
-
-ISO Entities
-
-The Linux Documentation Project has packaged all the Entities into one big tar file and placed it at http://www.tldp.org/authors/index.html#resources for the convenience of the users. Thanks to TLDP for this.
-
-
-
-Norman Walsh's DSSSL
-Norman Walsh's DSSSL can be downloaded from the DocBook project website at http://sourceforge.net/project/showfiles.php?group_id=21935.
-
-
-
-At the time of writing this document docbook-dsssl-1.7.6 was available.
-
-
-
-LDP DSL
-
-The most important requirement is the ldp.dsl ;) It can be downloaded from http://www.tldp.org/authors/index.html#resources.
-
-
-
-HTMLDOC
-HTMLDOC can be used for converting the HTML to PDF. If you would like to produce PDF documents, please download HTMLDOC from
-http://www.easysw.com/htmldoc/software.php
-
-
-
-
-
- Installing Processing Tools
-In this section we will install all the tools in the appropriate
-directories. All the tools go in the /usr/local/dbtools/ directory. Create
-this directory using the following command:
-
-mkdir /usr/local/dbtools
-
-
-Installing OpenJade
-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:
-
-
-
- Change directories to /tmp/downloads.
-
-
- # cd /tmp/downloads
-
-
-
- Unzip the file.
-
-
- # gzip -d openjade-1.3.x.tar.gz
-
-
-
- Untar the file.
-
- # tar -xvf openjade-1.3.x.tar
-
-
-
- Change directories to openjade-1.3
-
- # cd openjade-1.3.x
-
-
-
- Run the ./configure command.
-
- # ./configure
- --prefix=/usr/local/dbtools/openjade
-
-
-
- Run the make command.
-
- # make
-
-
-
- Run the make install command. After
- this step the openjade binaries will be installed under
- /usr/local/dbtools/openjade.
-
- # make install
-
-
-
- Copy the dsssl
- directory from /tmp/downloads/openjade-1.3.x to
- /usr/local/dbtools/openjade
-
-
- # cp -dpR dsssl /usr/local/dbtools/openjade/
-
-
-
-
-
-
-Installing Norman Walsh's DSSSL
-
-
-In this step we will install Norman Walsh's DSSSL in appropriate
-place. The DSSSL does not have to be compiled.
-
-
-
-
- Change directories to /tmp/downloads
-
- # cd /tmp/downloads
-
-
-
- Unzip the file.
-
- # gzip -d docbook-dsssl-1.76.tar.gz
-
-
-
- Untar the file.
-
- # tar -xvf docbook-dsssl-1.76.tar
-
-
-
- Move the file to the /usr/local/dbtools/docbook-dsssl.
-
- # mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl
-
-
-
-
-
-
-Installing DocBook DTDs
-
-In this section we will install DocBook 3.1 (cause that is the
-one that I use), but you can use whichever DTD you prefer.
-
-
-
-
- Change directories to /usr/local/dbtools.
-
- # cd /usr/local/dbtools
-
-
-
- Create a new directory called dtd3.1.
-
- # mkdir dtd3.1
-
-
-
- Change directories to the new directory.
-
- # cd dtd3.1
-
-
-
- Unzip the file.
-
- # unzip /tmp/downloads/docbk31.zip
-
-
-
-
-
-
-Installing the ISO Entities
-
-In this section we will install the ISO entities that we downloaded from the LDP website.
-
-
-
- Change directories to the /usr/local/dbtools/dtd3.1 directory.
-
- # cd /usr/local/dbtools/dtd3.1
-
-
-
- Copy /tmp/download/entities.tar.gz
- to this directory.
-
- # cp /tmp/download/entities.tar.gz .
-
-
-
- Unzip the file.
-
- # gzip -d entities.tar.gz
-
-
-
- Untar the file.
-
- # tar -xvf entities.tar
-
-
-
-
-
-
-Installing LDP DSL
-Finally we install the ldp.dsl.
-
-
-
- Change directories to the /tmp/download directory.
-
- # cd /tmp/download
-
-
-
- Copy the ldp.dsl file to the
-
-/usr/local/dbtools/docbook-dsssl/print/ldp.dsl
-directory.
-
- # cp ldp.dsl
- /usr/local/dbtools/docbook-dsssl/print/ldp.dsl
-
-
-
- >Copy the ldp.dsl file to the
-
-/usr/local/dbtools/docbook-dsssl/html/ldp.dsl
-directory.
-
- # cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html/ldp.dsl
-
-
-
-
-
-
-Installing HTMLDOC
-This step is optional. It is only required if you want to produce PDF documents
-Change back to the downloads directory
-
- # Change to /tmp/download directory
-
-Untar the source code for HTMLDOC
-
- # gzip -d htmldoc-1.8.xx-source.tar.gz
- # tar -xvf htmldoc-1.8.xx-source.tar
- # cd htmldoc-1.8.xx-1
-
-run configure to set the installation location
-
- # ./configure --prefix=/usr/local/dbtools/htmldoc
- # make
-
-
-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
-
-Here is the error you will get while running make install
-
- # make install
-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
-
-
- To fix this installation issue, please edit fonts/Makefile and comment out the lines with references to ZapfChancery and ZapfDingbats fonts
-
-Then execute the install:
-
-# make install
-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...
-
-
-
-
-
-
-
-
-
-
-
-
-
-Using OpenJade
-
-In this section we will use OpenJade to convert SGML documents to HTML and RTF.
-
-Setting the SGML_CATALOG_FILES Environmental Variable
-The SGML_CATALOG_FILES variable must be set to point to appropriate
-catalog files. To set the variable, use the following command:
-
-# export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog
-
-
-
-
-SGML to HTML
-
-
-To convert from SGML to HTML, use the following command:
-
-
-
- # /usr/local/dbtools/openjade/bin/openjade -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml
-
-
-To create a non-chunked (all in one) output:
-
- # /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
-
-
-
-
-
-
-SGML to RTF
-
-
-To convert from SGML to RTF, use the following command:
-
-
-
- # /usr/local/dbtools/openjade/bin/openjade -t rtf -d /usr/local/dbtools/docbook-dsssl/print/ldp.dsl#print DocBook-OpenJade-SGML-XML-HOWTO.sgml
-
-
-
-
-HTML to PDF
-
-To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output of the SGML:
-
- # /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
-
-
-The run HTMLDOC to produce PDF
-
- # /usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+ DocBook XML/SGML Processing Using OpenJade
+
+
+ Saqib
+ Ali
+
+
+ saqib@seagate.com
+
+
+
+
+
+
+
+ v1.3
+ 2002-08-02
+ sa
+
+ Added the "Additional Reseources" section.
+
+
+
+
+
+ v1.2
+ 2002-07-23
+ sa
+
+ Added the section on converting HTML -> PDF using HTMLDOC. Thanks to Luc De Louw for the suggestion.
+
+
+
+
+ v1.1
+ <2002-07-19
+ KET
+ fixed grammatical errors, numbered processes
+
+
+
+ v1.0
+ 2002-06-29
+ sa
+
+ Initial public release.
+
+
+
+
+
+
+
+ This HOWTO explains setting up OpenJade to process SGML/XML DocBook documents.
+
+
+
+
+Introduction
+
+ The objective of this document is to setup OpenJade to convert DocBook 3.2 and 4.2 (SGML/XML) documents to HTML, RTF, and PDF.
+
+
+
+Copyright and License
+
+This document is Copyright 2001 by Saqib Ali. Permission is granted
+to copy, distribute and/or modify this document under the terms of
+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
+http://www.gnu.org/copyleft/fdl.html
+
+
+
+What is DocBook?
+
+
+DocBook is document type definition (DTD). DocBook is a commonly used DTD for writing technical documents. 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.
+
+
+
+
+What is DSSSL?
+A Document Style Semantics and Specification Language (DSSSL)
+defines how to convert an SGML document into a human-readable format.
+
+
+
+
+What do we need?
+
+The tools needed to set up OpenJade for converting SGML and XML are:
+
+
+ OpenJade
+ Entities
+ Norman Walsh's DSSSL
+ DocBook DTDs
+ LDP DSL
+
+
+Note
+ All of these packages are free and are available for
+ download on the net. The next chapter explains how to download these packages.
+
+
+
+The only tool that you is compiled is OpenJade. The rest of the tools
+have to be extracted and placed in the right directories.
+
+
+
+
+Assumptions
+
+ This document assumes that you have the following already
+installed on your system.
+
+
+ gzip or gunzip - available from http://www.gnu.org
+ gcc and GNU make - available from http://www.gnu.org
+
+
+
+
+
+
+
+Requirements
+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.
+
+
+Pre-requirements
+
+
+Create a directory /tmp/downloads. We will use this directory to store the downloaded source code.
+
+
+
+OpenJade
+OpenJade will be used to process DocBook documents. OpenJade can be downloaded from:
+http://openjade.sourceforge.net/.
+
+
+At the time of writing this document OpenJade 1.3.1 was available. Download the openjade-1.3.x.tar.gz file
+
+
+
+DocBook DTD
+All the DocBook DTDs are available from The Linux Documentation Project website at http://www.tldp.org/authors/index.html#resources
+
+Please download DocBook SGML v4.1, DocBook SGML v3.1, and DocBook XML v4.1.2
+
+
+Note
+ Please download the whole zip archive.
+
+
+
+
+ISO Entities
+
+The Linux Documentation Project has packaged all the Entities into one big tar file and placed it at http://www.tldp.org/authors/index.html#resources for the convenience of the users. Thanks to TLDP for this.
+
+
+
+Norman Walsh's DSSSL
+Norman Walsh's DSSSL can be downloaded from the DocBook project website at http://sourceforge.net/project/showfiles.php?group_id=21935.
+
+
+
+At the time of writing this document docbook-dsssl-1.7.6 was available.
+
+
+
+LDP DSL
+
+The most important requirement is the ldp.dsl ;) It can be downloaded from http://www.tldp.org/authors/index.html#resources.
+
+
+
+HTMLDOC
+HTMLDOC can be used for converting the HTML to PDF. If you would like to produce PDF documents, please download HTMLDOC from
+http://www.easysw.com/htmldoc/software.php
+
+
+
+
+
+ Installing Processing Tools
+In this section we will install all the tools in the appropriate
+directories. All the tools go in the /usr/local/dbtools/ directory. Create
+this directory using the following command:
+
+mkdir /usr/local/dbtools
+
+
+Installing OpenJade
+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:
+
+
+
+ Change directories to /tmp/downloads.
+
+
+ # cd /tmp/downloads
+
+
+
+ Unzip the file.
+
+
+ # gzip -d openjade-1.3.x.tar.gz
+
+
+
+ Untar the file.
+
+ # tar -xvf openjade-1.3.x.tar
+
+
+
+ Change directories to openjade-1.3
+
+ # cd openjade-1.3.x
+
+
+
+ Run the ./configure command.
+
+ # ./configure
+ --prefix=/usr/local/dbtools/openjade
+
+
+
+ Run the make command.
+
+ # make
+
+
+
+ Run the make install command. After
+ this step the openjade binaries will be installed under
+ /usr/local/dbtools/openjade.
+
+ # make install
+
+
+
+ Copy the dsssl
+ directory from /tmp/downloads/openjade-1.3.x to
+ /usr/local/dbtools/openjade
+
+
+ # cp -dpR dsssl /usr/local/dbtools/openjade/
+
+
+
+
+
+
+Installing Norman Walsh's DSSSL
+
+
+In this step we will install Norman Walsh's DSSSL in appropriate
+place. The DSSSL does not have to be compiled.
+
+
+
+
+ Change directories to /tmp/downloads
+
+ # cd /tmp/downloads
+
+
+
+ Unzip the file.
+
+ # gzip -d docbook-dsssl-1.76.tar.gz
+
+
+
+ Untar the file.
+
+ # tar -xvf docbook-dsssl-1.76.tar
+
+
+
+ Move the file to the /usr/local/dbtools/docbook-dsssl.
+
+ # mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl
+
+
+
+
+
+
+Installing DocBook DTDs
+
+In this section we will install DocBook DTDs.
+
+
+
+
+ Change directories to /usr/local/dbtools.
+
+ # cd /usr/local/dbtools
+
+
+
+ Create a new directory called dtd3.1 dtd4.1 dtd4.1.2.
+
+ # mkdir dtd3.1
+ # mkdir dtd4.1
+ # mkdir dtd4.1.2
+
+
+
+ Change directories to the dtd3.1.
+
+ # cd dtd3.1
+
+
+
+ Unzip the file DocBook SGML v3.1 in this directory.
+
+ # unzip /tmp/downloads/docbk31.zip
+
+
+
+
+ Change directories to the dtd4.1.
+
+ # cd ../dtd4.1
+
+
+
+ Unzip the file DocBook SGML v4.1 in this directory.
+
+ # unzip /tmp/downloads/docbk41.zip
+
+
+
+
+ Change directories to the dtd4.1.2.
+
+ # cd ../dtd4.1.2
+
+
+
+ Unzip the file DocBook SGML v4.1.2 in this directory.
+
+ # unzip /tmp/downloads/docbk412.zip
+
+
+
+
+
+
+
+
+Installing the ISO Entities
+
+In this section we will install the ISO entities that we downloaded from the LDP website.
+
+
+
+ Change directories to the /usr/local/dbtools/dtd3.1 directory.
+
+ # cd /usr/local/dbtools/dtd3.1
+
+
+
+ Copy /tmp/download/entities.tar.gz
+ to this directory.
+
+ # cp /tmp/download/entities.tar.gz .
+
+
+
+ Unzip the file.
+
+ # gzip -d entities.tar.gz
+
+
+
+ Untar the file.
+
+ # tar -xvf entities.tar
+
+
+
+
+
+
+Installing LDP DSL
+Finally we install the ldp.dsl.
+
+
+
+ Change directories to the /tmp/download directory.
+
+ # cd /tmp/download
+
+
+
+ Copy the ldp.dsl file to the
+
+/usr/local/dbtools/docbook-dsssl/print/ldp.dsl
+directory.
+
+ # cp ldp.dsl
+ /usr/local/dbtools/docbook-dsssl/print/ldp.dsl
+
+
+
+ >Copy the ldp.dsl file to the
+
+/usr/local/dbtools/docbook-dsssl/html/ldp.dsl
+directory.
+
+ # cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html/ldp.dsl
+
+
+
+
+
+
+Installing HTMLDOC
+This step is optional. It is only required if you want to produce PDF documents
+Change back to the downloads directory
+
+ # Change to /tmp/download directory
+
+Untar the source code for HTMLDOC
+
+ # gzip -d htmldoc-1.8.xx-source.tar.gz
+ # tar -xvf htmldoc-1.8.xx-source.tar
+ # cd htmldoc-1.8.xx-1
+
+run configure to set the installation location
+
+ # ./configure --prefix=/usr/local/dbtools/htmldoc
+ # make
+
+
+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
+
+Here is the error you will get while running make install
+
+ # make install
+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
+
+
+ To fix this installation issue, please edit fonts/Makefile and comment out the lines with references to ZapfChancery and ZapfDingbats fonts
+
+Then execute the install:
+
+# make install
+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...
+
+
+
+
+
+
+
+
+
+
+
+
+
+Using OpenJade
+
+In this section we will use OpenJade to convert SGML documents to HTML, RTF, and PDF. You can download a sample DocBook 3.1 SGML file from http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.sgml
+
+
+
+Setting the SGML_CATALOG_FILES Environmental Variable
+The SGML_CATALOG_FILES variable must be set to point to appropriate
+catalog files. To set the variable, use the following command:
+
+# export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog
+
+
+
+
+SGML to HTML
+
+
+To convert from SGML to HTML, use the following command:
+
+
+
+ # /usr/local/dbtools/openjade/bin/openjade -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml
+
+
+To create a non-chunked (all in one) output:
+
+ # /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
+
+
+
+
+
+
+SGML to RTF
+
+
+To convert from SGML to RTF, use the following command:
+
+
+
+ # /usr/local/dbtools/openjade/bin/openjade -t rtf -d /usr/local/dbtools/docbook-dsssl/print/ldp.dsl#print DocBook-OpenJade-SGML-XML-HOWTO.sgml
+
+
+
+
+HTML to PDF
+
+To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output of the SGML:
+
+ # /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
+
+
+Then run HTMLDOC to produce PDF
+
+ # /usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html
+
+
+
+
+
+
+Further Information
+This section has some pointers to the related resource on the internet.
+ If you would like to suggest additional resource for this section, please email me @ saqib@seagate.com. Thanks.
+
+News groups
+ Some of the News groups of interest are:
+
+ comp.text.sgml (easily accessible from http://www.deja.com)
+ comp.text.xml (easily accessible from http://www.deja.com)
+ htmldoc.general (server - nttp://news.easysw.com)
+
+
+
+
+Mailing Lists
+ Here are some relevant Mailing Lists
+
+ DocBook mailing list @ OASIS. Visit http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml for more info.
+ DocBook mailing list @ TLDP. Visit http://www.tldp.org/mailinfo.html for more info.
+ xml-doc @ Yahoo Groups. Visit http://groups.yahoo.com/group/xml-doc/ for more info.
+
+
+
+
+
+IRC
+
+ DocBook IRC Channel. #docbook on irc://irc.openprojects.net
+
+
+
+Web Sites
+
+ http://www.oasis-open.org/ OASIS maintains various DocBook DTDs
+ http://docbook.org/wiki/moin.cgi/The DocBook Wiki
+ http://www.docbook.org/tdg/en/Online version of DocBook: The Definitive Guide
+ http://www-106.ibm.com/developerworks/library/l-docbk.htmlA gentle guide to DocBook (very good introduction).
+
+
+
+Commercial Tools
+
+ DocPro by Command Prompt, INC. http://www.commandprompt.com/entry.lxp?lxpe=2
+ YAWC Pro by XML Workshop LTD. http://www.yawcpro.com/. Can be used for converting MS Word to Simple DocBook XML.
+ Logictran RTF Converter. http://www.logictran.com/. Word/RTF to HTML/XML
+ MajiX - Word to XML converter. http://tetrasys.dhs.org/
+ XMETAL by SoftQuad http://www.softquad.com/
+
+
+
+
+
+
diff --git a/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml b/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml
index c6582360..6bb7a576 100644
--- a/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml
+++ b/LDP/howto/docbook/HOWTO-INDEX/howtoChap.sgml
@@ -729,7 +729,7 @@ How to become a totally "small time" DNS admin.
DocBook-OpenJade-SGML-XML-HOWTO,
DocBook XML/SGML Processing Using OpenJade
-Updated: July 2002.
+Updated: August 2002.
Explains setting up OpenJade to process SGML/XML DocBook documents.
diff --git a/LDP/howto/docbook/HOWTO-INDEX/miscSect.sgml b/LDP/howto/docbook/HOWTO-INDEX/miscSect.sgml
index c9f1ba7b..288d5bf0 100644
--- a/LDP/howto/docbook/HOWTO-INDEX/miscSect.sgml
+++ b/LDP/howto/docbook/HOWTO-INDEX/miscSect.sgml
@@ -35,7 +35,7 @@ system.
DocBook-OpenJade-SGML-XML-HOWTO,
DocBook XML/SGML Processing Using OpenJade
-Updated: July 2002.
+Updated: August 2002.
Explains setting up OpenJade to process SGML/XML DocBook documents.