views:

104

answers:

1

Consider the requirements for embedding help in a Java desktop application (or applet):

  • Single source for content (such as AsciiDoc) to generate high quality PDF manuals1
  • Hooks for context-sensitive help
  • Robust, simple, and well documented API (under an hour to learn)
  • Small footprint (a sub-100K Java archive)2
  • Integrate as a docked MDI-style window, or a separate window
  • Free open source software

Google says:

Which of these, or any others, would you recommend?

1Storing the content in AsciiDoc format would be ideal, so long as conversion is trivial.
2Up to 500kb.

+1  A: 

Have a look at DocBook - last time I looked it could generate PDF, HTML and JavaHelp from files written in DocBook XML .

A crash course is available at: http://opensource.bureau-cornavin.com/crash-course/

Thorbjørn Ravn Andersen
Am wondering more about the Java APIs -- is JavaHelp, for example, a suitable tool to use? I've taken a peek at DocBook before; thanks for the reminder.
Dave Jarvis
JavaHelp is the tool Sun provides for help. I have not heard of any other package to do so (except for the help in Eclipse, which probably is way over your head).
Thorbjørn Ravn Andersen