Fog Creek Software
Discussion Board




Good software for HTML Help

We've used the old .hlp help files in the past, but we're running into the limits of it with hyperlinks, and it's not compatible with .NET.  So we have been looking at HTML Help.  We downloaded the HTML Help Workshop from Microsoft, and we think it's junk.

What is a quality HTML Help software?

Walt
Tuesday, March 25, 2003

http://www.helpandmanual.com.

Best thing I've used, and I've used them all.

Tim Sullivan
Tuesday, March 25, 2003

I haven't used it personally, but every time I've asked this question of developers, Help and Manual has been the answer.

Oddly, nobody has ever, ever said "Robohelp"

Philo

Philo
Tuesday, March 25, 2003

I give another vote for Help & Manual, and I do use it.

Troy King
Tuesday, March 25, 2003

Depending on what kind of manual you want to produce,
Doxygen [ http://www.doxygen.org ] + HTML Help Workshop from Microsoft (links from Doxygen tool page) might be an excellent choice;

It reads source files in Java, C, C++, PHP, files in (simplified) HTML or it's own simple markup language, and produces an indexed, cross referenced manual in plain HTML, Compressed HTML (HTML Help), RTF, Latex, XML, and even man pages should you care.

Coupled with GraphViz (aka 'dot'), it will also diagram the class, package, and file relationships for you.

I wouldn't recommend it as a general purpose help tool though - it's mostly useful if a significant part of your doc (say, > 50%) is documentation of code.

And it's 100% open source and free (with the exception of MS HTMLHelp workshop).

Ori Berger
Tuesday, March 25, 2003

RoboHelp HTML from www.ehelp.com

I've tried over 20 products and nothing comes near it for easy of use.

Marc
Tuesday, March 25, 2003

Marc, you're just being contrary.

Philo

Philo
Wednesday, March 26, 2003

I'm happy with RoboHelp. It give you a lot of control over how the pages are generated and it works reliably on IE and Netscape on the Mac and PC (with a hand-edited changes to the CCS files).

My only complaint is that the generated files are *big* and they takes a long time to load. Not a problem if the help system stays open, but a frustration if users need context-sensitive help and are frequently reloading the help system.

An example of a tutorial I wrote using RoboHelp can be found here: http://www.forio.com/broadcast_tutorial.htm

Michael Bean
Wednesday, March 26, 2003

But Philo, I live to contradict you. :)

Marc
Wednesday, March 26, 2003

*  Recent Topics

*  Fog Creek Home