4. Utilisation d'OpenJade

Dans cette section, nous utiliserons OpenJade pour convertir des documents DocBook SGML/XML en HTML, RTF, et PDF.

4.1. Traitement du SGML

4.1.1. Définition de la variable environnementale SGML_CATALOG_FILES pour le SGML

La variable SGML_CATALOG_FILES doit être définie pour pointer sur les fichiers catalog appropriés. Pour définir la variable, utilisez la commande suivante pour le 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

Pour le C shell, utilisez cette commande :

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

4.1.2. SGML vers HTML

Pour convertir du SGML en HTML, utilisez la commande suivante :

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

Pour créer un document d'une pièce (tout dans un seul fichier) :

# /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 vers RTF

Pour convertir du SGML en RTF, utilisez la commande suivante :

# /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. Traitement du XML

Vous pouvez télécharger un exemple de fichier DocBook 4.1.2 XML à http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml

4.2.1. Définition de la variable environnementale SGML_CATALOG_FILES pour le XML

La variable SGML_CATALOG_FILES doit être définie pour pointer sur les fichiers catalog appropriés. Pour définir la variable, utilisez la commande suivante pour le 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

Pour le C shell, utilisez cette commande :

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

4.2.2. XML vers HTML

Pour convertir du XML en HTML, utilisez la commande suivante :

# /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 vers RTF

Pour convertir du XML en RTF, utilisez la commande suivante :

# /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 vers PDF (optionnel)

Pour convertir du HTML en PDF, il faut utiliser HTMLDOC. Tout d'abord, créez un fichier HTML d'une pièce à partir du 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

Maintenant, exécutez HTMLDOC pour générer le PDF.

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