This content has been marked as final. Show 6 replies
I'm not real familiar with RH_ShowHelp() for WebHelp as I work almost exclusively with compiled help. I do know that bookmarks don't work in compiled help if you shortcut around the .ali file (using the map number in the .hh file - e.g. #define topicname.htm#bookmark map number - instead of a mapID), generating exactly what you describe.
What is the syntax of your showHelp call? What do your .hh and .ali files look like?
Thanks for the help! You could be right, it might not even be possible to use context sensitive help to call a bookmark. However, I assumed it was since RoboHelp allows you to link a Map ID to a bookmark. In any case, information on the RH_ShowHelp() function is here.
I'm calling the function using the following parameters: RH_ShowHelp(0, 'http://server/project.htm>Window', HH_HELP_CONTEXT, 29). Map ID #29 is assigned to a bookmark in a topic, similar to this: topic.htm#bookmark.
I'm not familiar with .ali or .hh files, but here goes.... The .ali file basically lists each topic with its corresponding HTM file. I don't have a .hh file, however the .h file lists a #define for each mapped HTM file. One thing I noticed in the .h file is it looks like the # sign for the bookmark has been replaced with an underscore. So where it was topic#bookmark, it's now topic_bookmark. Not sure if that's significant....
Thanks again for you help!
You and the developer need to coordinate this issue: is the bookmark to be flagged with an underscore or a pound sign? The developer's call and your pathnames must agree, or must be aliased (.ali file).
An alternative is for the app to simply call the URL, without using the CSH API at all. That's what our C# app and WebHelp use. The developers assume all calls go through index.htm (to get the nav pane frameset; then they look for MainUserWindowFrm.htm if F1 is pressed in the MainUserWindowFrm window. Actually, they first look to field-level help, which we use only for certain windows, then to window-level, then bring up the home page if no window match is found. Because we use merged WebHelp, we also provide a text file in the output root that provides the folder name for each window topic ( ex: form_path.txt, with this format: MainUserWindowFrm, mergedProjects\menus).
Your ShowHelp lists the "project.htm" file, which seems to be the problem in the call that you fixed manually. Using HH_HELP_CONTEXT and a map number should work with the .ali and .h files you have. I would change the RH_ShowHelp call to get rid of the extraneous "project.htm" file.
Thanks, I'll give that a try. After closer inspection of the alias file, it looks correct to me... each reference to a bookmarked topic (topic_bookmark) in the .h file has the appropriate alias (topic.htm#bookmark). Thanks again, guys, for your help. I'll let you know what I find out.