4. Utilizzo di OpenJade

In questa sezione si utilizzerà OpenJade per convertire documenti dal formato DocBook SGML/XML nei formati HTML, RTF e PDF.

4.1. Trasformazione da SGML

4.1.1. Impostare la variabile di ambiente SGML_CATALOG_FILES per l'SGML

La variabile SGML_CATALOG_FILES deve essere impostata per puntare ai file di catalogo appropriati. Per impostare la variabile, si utilizzi il seguente comando per la shell Bourne:


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

Con la shell C si utilizzi invece:


# 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. Da SGML a HTML

Per convertire documenti da SGML a HTML, si usi il seguente comando:


# /usr/local/dbtools/openjade/bin/openjade -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml 

(NdT. In questo ed in altri esempi seguenti, si utilizza come file da trasformare il sorgente del presente documento)

Per creare in uscita un file non-chunked (tutto in una pagina):


# /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. Da SGML a RTF

Per convertire documenti da SGML a RTF, si usi il seguente comando:


# /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. Trasformazione da XML

È possibile scaricare un file di esempio in XML DocBook 4.1.2 da http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml.

4.2.1. Impostare la variabile di ambiente SGML_CATALOG_FILES per XML

La variabile SGML_CATALOG_FILES deve essere impostata per puntare ai file di catalogo appropriati. Per impostare la variabile, si utilizzi il seguente comando per la shell Bourne:


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

Con la shell C si utilizzi invece:


# 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. Da XML a HTML

Per convertire documenti da XML a HTML, si usi il seguente comando:


# /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. Da XML a RTF

Per convertire documenti da XML a RTF, si usi il seguente comando:


# /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. Da HTML a PDF (opzionale)

Per conversioni da HTML a PDF si dovrà usare HTMLDOC. Occorre prima creare un file HTML non-chunked dall'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 

Quindi si esegua HTMLDOC per produrre il file PDF.


# /usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html