Skip to main content
April 25, 2008
Question

Web Help vs. HTML Help

  • April 25, 2008
  • 5 replies
  • 2091 views
I just started using RH7 (upgraded form 2002). I have always used HTML Help to generate a .chm. The users of my help work at places where the IT departments often lock down Internet access; i.e., many users are not allowed access to the Internet. And our software only runs on Windows.

It seems help generated with Web Help can be more user friendly (I just like the idea of using skins, I guess) but I'm not sure it is worth doing in my case.

Anyone have any input on why I would switch to Web Help from HTML Help? Or is generating the .chm the best choice for my end users?

Also, if I do end up switching to WebHelp, how are context-sensitive IDs affected? Would the developers need to change anything on their end?

Thanks.

This topic has been closed for replies.

5 replies

Inspiring
April 28, 2008
Has anyone tested the shortuct control from a chm on a local hard drive where the primary browser is IE 6 or 7 and security settings are high or medium?

Harvey
Captiv8r
Legend
April 28, 2008
Hi Harvey

I use shortcuts all the time. And I have IE7 installed. They still seem to work just dandy.

Cheers... Rick
Peter Grainge
Community Expert
Community Expert
April 26, 2008
Bear in mind that to make webhelp work locally, you will have to select the Mark of the Web when you generate the help, that is what it is there for. It does however seem to prevent PDFs opening from links. May not be an issue for you.

Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
April 25, 2008
All good points. Thanks everyone. This is an interesting discussion.

Captiv8r - what is this Shortcut control of which you speak? Are there any examples you could pass on?
Participating Frequently
April 26, 2008
Hi, tlcraig,

You may also want to note that the contents of HTML Help files are blocked when they're stored on a network drive. If there's any likelihood that your users will be accessing the help remotely then you should consider WebHelp instead, or else be prepared to request that they implement the registry changes described here:

http://www.grainge.org/pages/authoring/chm_mspatch/896358.htm

Switching between HTML Help and WebHelp will require changes in the application code because the methods for calling the two types of help are different. See the online help for RoboHelp for code samples.

A ShortCut control permits users to open documents or programs that are external to the help file. From the online help for HTML Help Workshop:

"Shortcuts are hotspots that can launch another application, or take the user to a specific dialog box within an application. You can also use shortcuts to activate things like Windows control panels. Use shortcuts to make things easier for novice users, and speed experienced users through complex procedures."

Pete
Inspiring
April 25, 2008
The main trade-off is in updating help files. With a chm on a local hard drive, or WebHelp on a local hard drive, you need to deploy new help file(s) to each desktop.

With WebHelp on a server, you can update once for everyone.

Captiv8r
Legend
April 25, 2008
And on the flip side of that coin...

I admire .CHM format for its ability to use the Shortcut control. If I'm describing how to do something and it would be helpful for the user to open Windows Calculator, I can insert a Shortcut that will allow the user to click and actually open Calculator instead of just telling them how to open it.

Cheers... Rick
Inspiring
April 25, 2008
Our software runs only on Windows too and end users don't always have access to the internet, but we opted to go with Web Help instead of CHM. Management here liked the cool things I was able to do with custom skins. We include the Webhelp files right along with the application and they get automatically deployed to each user's computer during the s/w installation/upgrade process. The developers said that the overhead of my giant help system is not a factor (I guess it's relatively small compared to the application itself!).

We haven't implemented context-sensitive help yet (users just press F1 or click Help to launch the whole system), but I would suspect there would be no changes to your internal process. That's just a guess though.