views:

465

answers:

3

I need to document an application -- not the underlying source code. (I use Doxygen for the internal source code documentation.)

What are good documentation tools for producing HTML Help files? I know about the HTML Help Workshop, but I'm not very good at editing HTML files. I was hoping for something more integrated with a WYSIWYG editor.

I'm not restricting myself to free tools, but free is always nice. ;)

Thanks for your help!

  • Kevin
+2  A: 

The very best tool I know for this purpose is Help & Manual. It's not free, but it's worth the money.

anon
Kevin
+3  A: 

DocBook http://en.wikipedia.org/wiki/DocBook

Wow. DocBook is a standard and very flexible format -- able to be transformed into all sorts of other documents. That's good. The other nice thing is that there are multiple editors out there -- that's also good; in case one editor stagnates (or it's vendor goes out of buisness), you can always pick another.As far as WYSIWYG editors for DocBook go though, I've only found closed-source editors. Serna XML Editor offers a decent free version for non-corporate use. The professional version is still a little pricey ($559/seat on sale).Does anyone know of a free WYSIWYG DocBook editor?
Kevin
Ahh... I just found an open source WYSIWYG editor that exports to DocBook. It's called Lyx (http://en.wikipedia.org/wiki/LyX). I'm going to give this a try.
Kevin
I second DocBook. It just works great! +1
Sklivvz
+2  A: 

I know the final answer has been given, but what about (DokuWiki)? It has human readable plain text files and an easy to use wiki language. The important thing is: it can export to various formats (odt, html, plain text ...).

Using the Site Export you can easily create an offline - HTML only - version of your documentation. It also supports exporting JavaHelp and EclipseHelp TOCs.

gamma