4. Using OpenJade

In this section we will use OpenJade to convert DocBook SGML/XML documents to HTML, RTF, and PDF.

4.1. Processing SGML

4.1.1. Setting the SGML_CATALOG_FILES Environmental Variable for SGML

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:


# export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog

Use the following command for the C shell:


# setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog

4.1.2. 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 

4.1.3. 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 

4.2. Processing XML

You can download a sample DocBook 4.1.2 XML file from http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml

4.2.1. Setting the SGML_CATALOG_FILES Environmental Variable for XML

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:


# export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog

Use the following command for the C shell:


# setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog:/usr/local/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog

4.2.2. XML to HTML

To convert from XML to HTML, use the following 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

4.2.3. XML to RTF

To convert from XML to HTML, use the following 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

4.3. HTML to PDF (optional)

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