creating a CHM

Documents SQL Server 2000, 2005 and 2008 databases.


Moderators: David Atkinson, david connell, Charles Brown

creating a CHM

Postby AndrewRMClarke » Thu Oct 11, 2007 11:49 am

For some reason, I can no longer create a CHM help file. I have the latest version of the software but there are only two alternative output styles in the options dialog box. HTML with frames and HTML without frames.

The helpfile says 'To create database documentation in compiled HTML Help format (.chm), change this setting to Microsoft HTML Help (.CHM). Note that you must have Microsoft® HTML Help Workshop installed on your computer to create a .chm file; a free download is available from the Microsoft Download Centre.'. It used to work: now it doesn't.
AndrewRMClarke
 
Posts: 48
Joined: Wed Aug 16, 2006 3:17 pm
Location: Cavendish

Postby David Atkinson » Fri Oct 12, 2007 10:56 am

This is indeed strange. I've just tried on a clean setup and after installing the HTML Help Workshop (htmlhelp.exe) component, and restarting SQL Doc 1.2, the .CHM option correctly appears in the list of Documentation Style options.

Are you saying that it used to be in this list, and now it's gone? Or you've installed a new instance of SQL Doc and upon installing the HTML Help Workshop the option is not appearing as expected?

David Atkinson
Red Gate Software
David Atkinson
 
Posts: 1124
Joined: Mon Dec 05, 2005 4:54 pm
Location: Twitter: @dtabase

Postby AndrewRMClarke » Fri Oct 12, 2007 11:39 am

Yes, I have the HTML Help Workshop installed, the CHM option was on the list and has now vanished. I didn't install a new version of SQL Doc unless the installer did it for me without telling me. It is v 1.2. It has cheerfully done CHM files in the past! The only change I know of is that I registered it (it had been on 15 days when it worked)
AndrewRMClarke
 
Posts: 48
Joined: Wed Aug 16, 2006 3:17 pm
Location: Cavendish

Postby David Atkinson » Fri Oct 12, 2007 2:00 pm

This is a strange one. We've not had this reported by anyone else. Have you tried reinstalling the HTML Help Workshop?

David
David Atkinson
 
Posts: 1124
Joined: Mon Dec 05, 2005 4:54 pm
Location: Twitter: @dtabase

Postby AndrewRMClarke » Fri Oct 12, 2007 7:00 pm

Hmmm...
I tried various things. Eventually, I just ran the HTML Help Workshop, and tried various activities with it just to convince myself it was fully working.

Then SQL Doc suddenly decided it knew about CHM files.....

My guess is that a registry entry got changed by some process and HTML Help Workshop then changed it back when I fired it up.

For the next release, it might be better to change the user interface to give a warning message that CHM output is not available because it can't detect the HTML Help Workshop, rather than just removing it from the listbox. It's such an irritating design. I hate it when options are disabled, greyed out or removed without any way of finding out why. You may know why, but the PBU sure doesn't. Point and click then becomes stab and curse.
AndrewRMClarke
 
Posts: 48
Joined: Wed Aug 16, 2006 3:17 pm
Location: Cavendish

Postby David Atkinson » Mon Oct 15, 2007 10:49 am

We most definitely need to make the saving to .chm functionality more obvious. I'm convinced that a significant proportion of SQL Doc users don't know it exists! I've appended your comments to the existing issue in our bug tracking system and hopefully this will be rectified in the next release.

Thanks,

David Atkinson
Red Gate Software
David Atkinson
 
Posts: 1124
Joined: Mon Dec 05, 2005 4:54 pm
Location: Twitter: @dtabase

CHM file

Postby penny » Wed Nov 21, 2007 10:36 pm

I have installed HTML Help Workshop and had Red-Gate Doc installed prior. I do not have the option to save as a CHM file. I need this option to be available.. How do I get it?
penny
 
Posts: 3
Joined: Wed Nov 21, 2007 10:34 pm

Postby David Atkinson » Wed Nov 21, 2007 10:54 pm

Hi Penny,

You're doing the right thing. It should appear alongside the HTML options when you've installed the Help Workshop. What version of SQL Doc are you using? (in Help/About)

Kind regards,

David Atkinson
Red Gate Software
David Atkinson
 
Posts: 1124
Joined: Mon Dec 05, 2005 4:54 pm
Location: Twitter: @dtabase

creating CHM file

Postby penny » Wed Nov 21, 2007 11:10 pm

I have version 1.2.0.30 , I just reinstalled the HTML Workshop and I now I have the option under Options | Documentation Style.
penny
 
Posts: 3
Joined: Wed Nov 21, 2007 10:34 pm

Postby David Atkinson » Wed Nov 21, 2007 11:21 pm

Strange - it should have worked the first time! Let us know if you come across any further problems.

Kind regards,

David Atkinson
Red Gate Software
David Atkinson
 
Posts: 1124
Joined: Mon Dec 05, 2005 4:54 pm
Location: Twitter: @dtabase


Return to SQL Doc 1

Who is online

Users browsing this forum: No registered users and 0 guests