dtddoc: A DTD documentation generator

What is dtddoc?

dtddoc is a DTD documentation generator that can read a DTD and associated documentation written in XML and generate nicely formatted HTML documentation or, experimentally, DocBook RefEntry documentation. Later and more complete releases may provide features for supporting other formats as well.

Licence?

Python License (CNRI Python License), which means: dtddoc is free and you can do as you like with it. If you change it, please let us know. Or, even better, join the project at Sourceforge.

What's included?

At the moment, the following applications are included:

• dtddoc.py, which can create HTML, DocBook, and XML Topic Map (XTM) documentation. Topic map support requires tmproc to be installed.
• makeskel.py, which can read a DTD and generate a skeleton documentation file.

Documentation

At the moment dtddoc is a command-line application. It accepts the following parameters:

  dtddoc [opts] -f <format> dtdfile docofile outputfile

  Options:
  -h:              Print this message and exit
  -V:              Print version and exit.
  -e:              Don't make an element index
  -o:              Skip one-line element descriptions in element index
  -a:              Don't make an attribute index
  -s:              Be silent
  -t:              Be strict (require everything to be documented)
  -f <format>:     Output documentation in  (html, ref, xtm)
  -l <language>:   Output documentation in 
  -c <encoding>:   Use  when parsing DTD and XML-Description

  Required arguments:
  dtdfile:    The DTD
  docofile:   XML documentation for the DTD
  outputfile: Output destination

The DTD documentation DTD has been documented using dtddoc. You can see the DTD, the XML documentation or the generated HTML documentation.

Getting dtddoc

dtddoc is based on xmlproc and SAX and so requires you to have these installed. The easiest way to get these may be to install the Python XML-SIG package. dtddoc itself is available at Sourceforge.

Feedback

Any and all feedback is welcome, from suggestions for improvements or new features to bug reports. And we really mean it! If you have any opinions on this program or the documentation DTD, please let us hear them: Project page on Sourceforge

This project is sponsored with source code and developer time by WEB.DE AG, Karlsruhe, an independent provider of online services and one of the leading brands in the high-growth German Internet market.