/ 
XML-Handler-Dtd2Html-0.20
River stage zero No dependents
/ dtd2html

NAME

dtd2html - Generate a HTML documentation from a DTD

SYNOPSYS

dtd2html [-b | -f] [-C | -M] [-HZ] [-o filename] [-s style] [-t title] [-x 'example1.xml example2.xml ...'] file.xml

OPTIONS

-b

Enable the book mode generation.

-C

Suppress all comments.

-f

Enable the frame mode generation.

-H

Disable generation of href's in comments.

-M

Suppress multi comments, preserve the last.

-o

Specify the HTML filename to create.

-s

Generate an external style.css file.

-t

Specify the title of the HTML files.

-x

Include a list of XML files as examples.

-Z

Delete zombi element (e.g. without parent).

DESCRIPTION

dtd2html is a front-end for XML::Handler::Dtd2Html and its subclasses. It uses them to generate HTML documentation from DTD source.

Because it uses XML::Parser and an external DTD is not a valid XML document, the input source must be an XML document with an internal DTD or an XML document that refers to an external DTD.

The goal of this tool is to increase the level of documentation in DTD and to supply a more readable format for DTD.

It is a tool for DTD users, not for writer.

All comments before a declaration are captured.

All entity references inside attribute values are expanded.

This tool needs XML::SAX::Base, XML::SAX::Exception, XML::SAX::Expat and XML::Parser modules.

Comments

XML files (and DTD) can include comments. The XML syntax is :

<!-- comments -->

All comments before a declaration are captured (except with -M option). Each comment generates its own paragraph <p>.

Standard HTML

You can embed standard HTML tags within a comment. However, don't use tags heading tags like <h1> or <hr>. dtd2html creates an entire structured document and these structural tags interfere with formatting of the generated document.

So you must use entities &lt; &gt; &amp; within a comment.

dtd2html Tags

dtd2html parses tags that are recognized when they are embedded within an XML comment. These doc tags enable you to autogenerate a complete, well-formatted document from your XML source. The tags start with an @.

Tags must start at the beginning of a line.

The special tag @BRIEF puts doc in 'Name' section (in book mode).

The special tag @INCLUDE allows inclusion of the content of an external file.

<!--
  comments
  @Version : 1.0
  @INCLUDE : description.txt
  @See Also : REC-xml
-->

SEE ALSO

XML::SAX::Base , XML::SAX , XML::SAX::Expat , XML::Parser

XML::Handler::Dtd2Html

Extensible Markup Language (XML), <http://www.w3c.org/TR/REC-xml>

AUTHOR

Francois PERRAD, francois.perrad@gadz.org

COPYRIGHT

(c) 2002 Francois PERRAD, France. All rights reserved.

This program is distributed under the Artistic License.