Thursday, August 31, 2006

HTML Help Workshop must be installed to c:\program files\html help workshop - surely not!

Upon installing a NAnt script to our development server I began experiencing the following error - during the documentation task which uses NDoc to generate XML and CHM help files - MSDN style (using the MSDN documentor in the NDoc task).

Unable to find the HTML Help Compiler. Please verify that the HTML Help
Workshop has been installed.
Unable to find the HTML Help Compiler. Please verify that the HTML
HelpWorkshop has been installed


Of course, I had never had this problem on my own development machine - a machine running pretty standard installations of Visual Studio 2003 and Visual Studio 2005.

Naturally, these tools were not on the server.

So, initially, the HTML Help Workshop was not installed on that server. After downloading a setup for it from Microsoft I installed it onto the D: of that server - I like to keep unnecessary tools etc of the system drive (C:). However the error remained.

After trolling around for quite awhile not finding much, I had picked up a couple of clues as to where NDoc seems to get the information regarding the location of some of these external files (such as the help compiler hcc.exe) (see the XML configuration files under NDoc\bin\net\2.0). Anyway, it appears that the Help Compiler needed to be installed on c: drive.

Sure enough after removing my initial installation and re-installing it, this time to c:\program files, the NDoc task in the NAnt script worked!

I can't believe this is the final answer! Surely not. Surely there is a config file setting somewhere - of a registry key for the HTML Help Workshop I can set to avoid this???

4 comments:

  1. Anonymous9:21 AM

    Thank you thank you. I had this error too on an AMD64 system where the HTML Help Workshop installed to the C:\Program Files (x86) directory. After duplicating this directory under C:\Program Files, nDoc is working great!

    ReplyDelete
  2. i gave my girlfriend a diamond bracelt and she was quite pleased with it” design firms los angeles

    ReplyDelete
  3. We appreciate you the particular beneficial details! I might not have found out this particular personally! website design la

    ReplyDelete
  4. I just couldn’t depart your site prior to suggesting that I extremely enjoyed the standard information an individual provide for your visitors? Is gonna be back frequently in order to inspect new posts top web design companies

    ReplyDelete