HTML Help Workshop can't find the Header Files ( .h ) ?

[Medhat Nasr]

Hi Group,

Working With HTML Help Workshop 4.74.8702.0 , and need to use
Context-Sensitive HTML Files in my AccessXP .adp - custom Help file .

Here is the situation I'm having :
- Using the Notepad text editor, I created the ( Map.h ) and ( Alias.h )
files and saved them in the same directory of the HTML Help project .
- With the HtmlHelp API information page in my HTML Help project , I failed
to include these two Header files in the Map & Alias tap-pages respectively
! I always got this message "Cannot find the file Map.h .Do you want to
include this flle anyway ? ", and even when I used the Browse button ,Icould
not see any of these files in the Directory where I created and where they
really exist !

After reviewing the online-Help ,I understood that, this situation has
something to do with the Htmlhelp.lib and Htmlhelp.h files which are
already there in their default directories respectively :
C:\Program Files\HTML Help Workshop\Lib for Htmlhelp.lib
C:\Program Files\HTML Help Workshop\Include for Htmlhelp.h
Unfortunately I couldn't figure it out for sure , where else - in the
system - I should copy these files to make it work , so HTML Help Workshop
can find the the Header
files .

It would be most appreciated if you could guide me out of this .

Thanks

Medhat Nasr

 

[Pete Lees]

Medhat,

Working With HTML Help Workshop 4.74.8702.0 , and need to use
Context-Sensitive HTML Files in my AccessXP .adp - custom Help file .

Here is the situation I'm having :
- Using the Notepad text editor, I created the ( Map.h ) and ( Alias.h )
files and saved them in the same directory of the HTML Help project .
- With the HtmlHelp API information page in my HTML Help project , I failed
to include these two Header files in the Map & Alias tap-pages respectively
! I always got this message "Cannot find the file Map.h .Do you want to
include this flle anyway ? ", and even when I used the Browse button ,Icould
not see any of these files in the Directory where I created and where they
really exist !

I can't reproduce this problem, but I do know that the HtmlHelp API
Information dialog is rather flaky. Microsoft recommends that you edit
the [MAP] and [ALIAS] sections of your project file with a text editor
like Notepad rather than with HTML Help Workshop (see
http://support.microsoft.com/?kbid=188444). For more information on
how to set up the [MAP] and [ALIAS] sections, see:

http://www.mvps.org/htmlhelpcenter/htmlhelp/hhtutorials.html#mapping
http://helpware.net/htmlhelp/how_to_context.htm

I don't think the htmlhelp.lib and htmlhelp.h files are relevant in
this case.

If all else fails, and if you think it would help, please send your
source files to me. I'd be very happy to take a closer look at them.

 

[Pete Lees]

Hi Medhat,

Unfortunately, adding the prefix ( $global_ ) to the window types in the
.hhp file, didn't work.

If you haven't already tried this, I would recommend using the test
facilities in HTML Help Workshop to check the context-sensitive help
mappings in your .chm file. To do this:

1) On the Test menu, select HtmlHelp API.

2) In the Compiled File field, make sure that the name of your help
file is shown.

3) In the Command field, select HH_HELP_CONTEXT.

4) In the Map Number field, type a numeric ID that you specified in
your Map.h file.

If you can successfully open the help file without the error message
appearing, you'll know that the problem lies not in the help file
itself but in the way it is attached to the application.

I'd be happy to look at your source files if you can zip up and send
me the .chm, .hhp, and .h files.

I finally did uninstall/reinstall process , nothing's changed. It seems,
it's going to be a long while and a lot of effort before I get familiar
with HHW.

You may find the tutorial at
http://www.mvps.org/htmlhelpcenter/htmlhelp/hhtutorials.html useful.
I'd also recommend Jeannine Klein's book "Building Enhanced HTML Help
with DHTML & CSS" (http://www.jmek.net/html_help/), which is more
up-to-date and detailed than Steve Wexler's book for the Microsoft
Press ("Official Microsoft HTML Help Authoring Kit").

Is it regular for the HHW with an open project , that : the (What isthis? )
button does esist in all the tabbed dialog boxes , however , it doesn't
bring any Context-Sensitive Pop-ups for any of the dialogs' elements

Yes, this is a known problem. As I understand it, Microsoft's chief
developer for HTML Help retired shortly before HTML Help Workshop was
released, which is why the program (and to some extent HTML Help
itself) has a rather unfinished feel to it. Since his departure, many
of the glitches in the program have not been fixed.

 

[Medhat Nasr]

Hi Pete,

Any news ?
It's been a bit too long , if you've checked my HHW files , would you let
me know if you have found any thing wrong with it , specially for the
Context-Sensitive mapping files . Any news would be great .

Thanks in advance .

Medhat Nasr

Hi Pete,

I checked the context-sensitive help mappings using the "Test HtmlHelp API"
as you suggested . It reported the same HTML Help Author Message :

" HH_HELP_CONTEXT called without a [MAP] section "

I managed to resonablely minimize the size of my Help Project , and I'll
attach it to this message for your review .

Here are some time saving remarks regading this Help poject :

- Its language is set to Arabic (Egypt) , so you might have some changes in
Arabic Fonts due to the fonts available on your system .

- It is rather a stating plan than a complete Help project , just to layout
the main headers and pages with some selective topics , for practice and
testing the intended techniques to be used . I estimate the final size of
this file arround two thousands pages .

- I didn't include the ( .chm ) file to minimize the the attachment size -
you just open the ( .hhp ) in HHW and push the save and compile button and
you'll have it , I inclosed every thing in one place .

Thanks a lot , Pete .

Medlat

Hi Medhat,


If you haven't already tried this, I would recommend using the test
facilities in HTML Help Workshop to check the context-sensitive help
mappings in your .chm file. To do this:

1) On the Test menu, select HtmlHelp API.

2) In the Compiled File field, make sure that the name of your help
file is shown.

3) In the Command field, select HH_HELP_CONTEXT.

4) In the Map Number field, type a numeric ID that you specified in
your Map.h file.

If you can successfully open the help file without the error message
appearing, you'll know that the problem lies not in the help file
itself but in the way it is attached to the application.

I'd be happy to look at your source files if you can zip up and send
me the .chm, .hhp, and .h files.


You may find the tutorial at
http://www.mvps.org/htmlhelpcenter/htmlhelp/hhtutorials.html useful.
I'd also recommend Jeannine Klein's book "Building Enhanced HTML Help
with DHTML & CSS" (http://www.jmek.net/html_help/), which is more
up-to-date and detailed than Steve Wexler's book for the Microsoft
Press ("Official Microsoft HTML Help Authoring Kit").


Yes, this is a known problem. As I understand it, Microsoft's chief
developer for HTML Help retired shortly before HTML Help Workshop was
released, which is why the program (and to some extent HTML Help
itself) has a rather unfinished feel to it. Since his departure, many
of the glitches in the program have not been fixed.