[Doc-SIG] XML Conversion Update

hinsen@cnrs-orleans.fr hinsen@cnrs-orleans.fr
Fri, 27 Aug 1999 17:36:25 +0200

> >   I am not at all decided on a DTD to use.  I see three options:
> Im pretty ignorant about this.  I did look into the docbook DTD, and it is
> indeed complex.  However, it also appears that much of it is optional.
> It seems that if a reasonable subset of the docbook features could be used
> and documented for use in Python it would be simpler to use, and save
> reinventing the wheel.

I did use DocBook, and I certainly had lots of problems with it.
However, the real problem is not the complexity (for any given
project, most of DocBook markup is irrelevant), but the lack of decent
documentation. This might change when the O'Reilly book by Norman
Walsh is out.

The second problem I wasted a lot of time with is Jade plus JadeTeX; I
just couldn't get decent paper output with it. And I didn't really
want to learn DSSSL either. In the end I wrote my own special-purpose
converter using PyDOM, which was finished in a day!

So my suggestions are:

- Use DocBook-XML, or perhaps Norman Walsh's simplified DocBook,
  or something intermediate. Maybe some modifications must be
  made, but that is relatively simple.
- Use Python tools for conversion, that's what we are all most
  familiar with.

Konrad Hinsen                            | E-Mail: hinsen@cnrs-orleans.fr
Centre de Biophysique Moleculaire (CNRS) | Tel.: +33-
Rue Charles Sadron                       | Fax:  +33-
45071 Orleans Cedex 2                    | Deutsch/Esperanto/English/
France                                   | Nederlands/Francais