|Authors:||Lars Marius Garshol,||Gisbert Amm|
|Last release:||26. February 2004|
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.
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.
At the moment, the following applications are included:
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.
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.
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.