Context-Sensitive HELP!!!!!

Report · Feb 13, 2009

Has anyone successfully used FM markers to create Map IDs in RH for context-sensitive Web help? I'd love to know how to do it. Someone please correct me if my procedure is flawed. Here's what I've tried without any success (and much of this procedure comes from the Adobe online documentation):

1. Created a marker type in FM called "HelpID".
2. Entered three separate markers (ID1, ID2, and ID3) in Chp1. I've even tried using more descriptive marker entries, like "logging_on" and "welcome_screen".
3. Entered "HelpID" in the Other Settings area of the Content Settings tab (available by right-clicking over the book and selecting Properties).
4. Performed a force update on the book.
5. When I open the Edit Map IDs window from the Project Set-Up tab, I only have one Map ID, but it's not one of the markers I entered in FM. Where are my Map IDs?

Using RH 7.02 and FM 8.0p277.

I've tried many different methods to resolve this issue -- deleted the FM marker and created a new one; placed the markers at the beginning of paragraph text (as described in the Adobe online documentation); deleted the BSSCDefault.h file and regenerated help, just to mention a few.

Am I missing something here? I followed the limited FM/RH integration documentation exactly on this subject.

Report · Feb 13, 2009

Use anything but HelpID.

You still need to import a map file.

The content of the marker must be the unique entry in the map file for the ID you are targeting (eg. IDH_ABCABC_ABC). Look up my username, I went around and around early on trying to get this to work and finally did. There more be more detail in that (much older) thread.

Report · Feb 13, 2009

Thanks for responding to my issue, ^^&&^^. I appreciate your assistance; however, I'm still dumbfounded.

I created a WebHelp project, not an HTML-Help project. Don't know if that makes a difference with the problem I'm having.

I tried using a different marker name, but it made no difference (don't know why it would, but perhaps someone could explain).

As far as I understand, I don't need to import a map file. There are two ways to assign Map IDs: the developer can generate a map file, which the author can import into RH, or the author can generate the map file and provide this information to the developer. I would like to do the latter; I simply want to use the Map IDs that should be populated in the BSSCDefault.h map file according to the marker entries defined in FM.

I'm not at the stage where I can provide a map file to the developer; that's getting too far ahead of what I'm trying to accomplish. I simply want to see the marker entries in FM appear as Map IDs in RH.

In another thread, I did find the following information from Mayank of the RoboHelp team that explains what I'm trying to do:

Here is the flow in RoboHelp.
1. Help Author inserts his own Map IDs as marker text in the FrameMaker document. (e.g. HIDD_APP_PREF_FIRST_DIALOG)
2. Help Author mentions the name of the marker in RoboHelp during Add/Import of FrameMaker document.
3. RoboHelp reads the marker, marker text and the document content and generates Context Sensitive Help Map IDs. It also generates a .h (equivalent to .hm) file.
4. This .h file is provided by the help author to the developer to be used in his application.

In my case, RoboHelp does not generate Context-Sensitive Help Map IDs.

Report · Feb 24, 2009

For RH7 we need to import the map file (.h) which has the information about which of the Context Sensitive Help's are to be imported/generated on linking/Import even for the flow where "author can generate the map file and provide this information to the developer" we do have to import this Map file before updating link

For your case Map file will look like

#define ID1 1
#define ID2 2
#define ID3 3

then after updating the link and with "HelpID" in the Other setting field the Context Sensitive Help will get generated with the above mentioned IDs

here the string values of the Context Sensitive Help will be 'ID1' and numeric value of the Context Sensitive Help will be '1' for the first instance of the marker with marker text = 'ID1' and so on...

PS - Marker text serves as a Map ID