Pour obtenir un environnement d'édition viable, voici quelques points à mettre en oeuvre.

La variable d'environnement à définir dans votre shell préféré (Bash biensur ! ;-)) $SGML_CATALOG_FILES est un chemin de recherche vers les fichiers catalog qui recensent les fichiers de DTD DocBook et de DSSSL. En général $SGML_CATALOG_FILES=/etc/sgml/catalog.

Si l'on souhaite éditer sous emacs, je recommande le mode PSGML qui est un mode SGML générique mais qui connait la variable d'environnement $SGML_CATALOG_FILES, et qui comprend les DTD. A chaque niveau d'imbrication, il ne propose que les balises valides.

onsgml est un utilitaire de validation d'un fichier SGML par rapport à une DTD. Normalement, avec l'édition dans emacs, on ne rencontre pas de cas de documents mal formés. Mais cet utilitaire propose des messages clair lorsqu'il détecte des erreurs. Et il peut être utile au cas ou on n'a pas eu d'editeur spécialisé pour la saisie.

Les DocBook Modular StyleSheets sont des fichiers DSSSL paramètrables qui permettent rapidement d'utiliser la chaîne de compilation OpenJade sans devoir passer du temps à créer les fichiers de mise en forme. Créer des feuilles de styles est une activité à part entière qui réclame un niveau d'expertise bien supérieur à ce que l'utilisation de DocBook demande.

Enfin, OpenJade qui est l'évolution du Jade (JAmes Dsssl Engine) écrit par James Clark, logiciel libre qui permet de mettre en place la chaîne d'édition.