DocBook Doclet (Herold)

DocBook Doclet (dbdoclet) creates DocBook code from Java source documentation. DocBook Doclet is helpful, if you want to print reference handbooks of your API. The program can be used as javadoc doclet or as standalone application.

The standalone application can be used as a converter to transform HTML documents to DocBook documents. Additionally DocBookDoclet comes with a Swing application called dbdoclet.TiDBit, which helps you to manage your documentation projects and to create PDF files.

What is new in this release:

• New section detection via CSS class names.
• If your HTML contains headings that are not using the h1-6 tags, but via CSS formatted p, div, or similar tags, the new section detection can help you to create the proper sectioning structure in DocBook.
• List detection via CSS class names.
• Sometimes HTML contains "lists", which truly are special formatted paragraphs.
• The new list detection can help you to reconstruct the proper lists in DocBook.

What is new in version 6.0.2:

• Fixed usage of invalid values for align attribute.
• Fixed wrong normalization of literal environments.

What is new in version 5.4.0:

• Improved customization possibilities via groovy scripts.
• A fix for "invalid escape sequence error" in the parser.

What is new in version 5.2.4:

• Support for conversion of HTML fragments. Until now you got a ugly NullPointerException when trying to convert an incomplete HTML document.
• Improved detection of the title of the document from the HTML code. Now the xpath expressions /html/head/title, //h(1-6)[1] and //text()[1] are used to find a hopefully reasonable title.
• The new HTML parser didn't treat HTML comments inside of text correctly. Now the comments are located and removed from the DocBook XML.

Requirements:

• To run dbdoclet you need the JDK 1.4 or 1.5.
• dbdoclet creates an appendix with statistical information. Therefore it uses the jfreechart library. While creating the images, access to a graphical context (like a X-Server) is necessary. If you want to run dbdoclet in a headless environment, specify th