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