Hoglet 0.2 review

Hoglet allows special markup to be added to text documents so that software documentation can be easily produced. It provides a co

License: The Apache License 2.0 File size: 0K Developer: Gary Bentley

0

Hoglet allows special markup to be added to text documents so that software documentation can be easily produced.

It provides a configurable parser, simple markup rules, and extensible "tag handlers" that allow custom Java code to process content.

What's New in This Release:
New Features
The Code Handler has been enhanced to provide highlighting of code comments (single and multi-line) and strings. Also, it is now possible to select code directly from a source file and have that formatted, saving needless typing. Shortcuts to file/http urls for frequently referenced code is also supported. For example:
[java hoglet,org.hoglet.Processor,lines=50:100/]
would select lines 50 - 100 from file org/hoglet/Processor.java from the directory pointed to by shortcut: hoglet.
The Link Handler has been enhanced to support shortcuts for frequently referenced urls. For example:
[link hoglet,release-notes.html]Release Notes[link]
would produce a link to file release-notes.html prefixed with a url pointed to by shortcut: hoglet.
The XML Handler has been enhanced to provide highlighting of the xml. Also, the xml to highlight can be selected from a source xml file. The exact element to select is specified via a modified XPath expression. Shortcuts to file/http urls for frequently referenced files is also supported. For example:
[xml hoglet,data/tag-handlers.xml,/tagHandlers/handler@tag:xml/init/]
would produce highlighted xml for element init (with parent path /tagHandlers/handler for the handler element that has an attribute named: tag with value: xml). The xml would be selected from file data/tag-handlers.xml from the directory pointed to by shortcut: hoglet.

Bug Fixes
Modified org.hoglet.Processor so that parsing of escaped characters within option name/values is performed correctly.
Fixed DirectoryProcessor so that the output directory path is calculated correctly. Also, the recursion parameter is now respected.

Changes
Modified LinkHandler so that it will also consider urls starting with https to be external.