header (.h) file, anchor tags, and CSH

Report · Oct 14, 2021

I am trying to create context sensitive markers in FM 2020. I've inserted topic alias markers in the specific parts of the doc and tried to create the .h (UTF-8 encoded) file needed for the CSH. I used #define <mapID> <map number> for each of the topic alias markers I inserted. The .h file contains the #define statements only. I put the file in the same location as my book file and generated Responsive HTML as the instructions on this forum state. Does this create an anchor tag? And what format will that tag have? How can I search for that in my output as searching for "<a class=" does return results. Also can yo use dashes in the map ID and map number?

Report · Oct 19, 2021

I thought it now creates a .ali file instead? Maybe that's the new RH2020 format. In any case, if it's still a .h file, FM should create it for you when you Publish. Your Settings screen should let you indicate what the marker type you want to use for CSH (iirc).

Report · Oct 21, 2021

I don't see a .ali file. What does the .h file do? I've followed the FM instructions but when I look in the HTML output, I don't see any /a (anchor) tags with href. What do I look for in the HTML output to verify that the mapping worked? My dev tells me that the code is not there so he cannot find the HTML page to display. I'm looking for something like this:

But the dev says that the correct format is:

where GI-SVC-CEC-CMP is the Topic Alias marker. I don't know where the 108 number comes from.

Report · Oct 21, 2021

Oh, hang on - this thread talks about the process - https://community.adobe.com/t5/framemaker-discussions/context-sensitive-help-in-fm-2017-map-file-and... - my suspicion is that the .h file you manually create has to reside in the output folder too. (there's also the issue of not being able to use your own custom CSH marker types anymore to create the .h file definitions - that's https://tracker.adobe.com/#/view/FRMAKER-9911 )

Report · Feb 11, 2022

The .h file the you create has to reside in the same directory as the FM book file and have the same name as the book file (<book>.h and <book>.book). When the help is generated, the .h file is recreated or copied into the output folder. However, I haven't been able to generate working CSH using FM 2020. The CHM file is created, but the CSH does not work. However, help generated with the same source files in FM 2019 works fine.