Skip to main content
Participant
April 5, 2015
Question

Creation of context sensitive help with pure FM 12 usage doesn't work

  • April 5, 2015
  • 1 reply
  • 428 views

Hi,

I hope somebody is able to help me with a good hint or tip.

I am trying to create a context-sensitive Microsoft Help with FM12 only using the abilities of FM (no RoboHelp). For some reasons, my assigned ID's are not used in the generated chm file and therefore the help does not work context-sensitively.

What did I do?

- I created my FM files and assigned topic aliases to the headers. I did this two ways: a) using the "Special" menue and assigning a CSH marker and/or b) setting a new marker of type "Topic Alias" and typing the ID. I used only numeric IDs like "2000" or "4200",

- I created a .h file (projectname.h) - based on the format of the file projectname_!Generated!.h (I read this in some instructions). So the .h file (text file) looks like this:

#define 2000 2000 /* 4 Anwendungsoberfläche */

#define 2022 2022 /* 4.1.1 Menü Datei */

#define 2030 2030 /* 4.1.3 Menü Parametersatz */

#define 2180 2180 /* 6.6.7 Objektdialog Q-Regler */

#define 2354 2354 /* 6.9.2 Objektdialog Extran Parameter */

#define 2560 2560 /* 6.9.5 Objektdialog Extran2D ­Parametersatz */

- I published the Microsoft HTML Help. A projectname_!Generated!.h has been created. My IDs were not used in this file:

#define 2000    1

#define 2022    2

#define 2030    3

#define 2180    4

#define 2354    5

#define 2560    6

- When I open the .chm file and look in the source code, the ID even is totally different. It is not the one, I assigned in FM, it is not the one which I assigned in the projectname.h file and it even is not the one, which was put in the projectname_!Generated!.h file. It is a generated name starting with CSH_1 ...n in a consecutive way numbered.

Example:

<p class="FM_Heading1"><a name="XREF_72066_13_Glossar"></a>Gloss<a name="CSH_1"></a>ar</p>


What goes wrong? Why does FM not take my assigned IDs? I need to use these IDs since our programmers are using those already - I had to re-create the whole online help but the programs stay untouched.


Please help!

Many thanks

Mohi

    This topic has been closed for replies.

    1 reply

    Jeff_Coatsworth
    Community Expert
    Community Expert
    April 6, 2015

    What does your marker text have in it? I created a CSHMarker type and just place the one-word text string I need to launch from my application to the relevant help page. So for example, I use GJP24T4 as the marker text and in my .h file it translates to #define GJP24T4 2

    Mohi_sstAuthor
    Participant
    April 6, 2015

    Hi Jeff,

    thanks for your note!

    The text in my marker is just a number like "2000" or "4200". As said, I created manually a my.h file and used this marker there. E.g.

    #define 2000 2000.

    Whereby the first 2000 (in my opinion) is the marker text and the second 2000 is the context ID which the programmers are using for the context sensitive call of the help. My definitions in the my.h file were translated to #define 2000 1 (in the my_!Generated!.h file). The source code "translates" the context ID into CSH_8.

    I am still confused :-/

    Thanks

    Mohi

    Jeff_Coatsworth
    Community Expert
    Community Expert
    April 6, 2015

    Nope, the first 2000 is what the programmers call – that corresponds to the 1, or 2 or 3, etc. that the MapID is assigning to the topics. I’m not sure in the FM publish route where the link is made (or can be seen) to the resulting topics.