Skip to main content
Participant
Oct 14, 2021 9:02 PM UTC
Question

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

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?

This topic is closed to new replies. Start a new post to keep the conversation going.

4 replies

Jeff_Coatsworth
Community Expert
Community Expert
Oct 21, 2021 7:17 PM UTC

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-code/m-p/9210301 - 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 )

Translate
AlNotAI0249
Inspiring
Feb 12, 2022 1:21 AM UTC

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. 

Translate
Jeff_Coatsworth
Community Expert
Community Expert
Oct 19, 2021 12:20 PM UTC

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).

Translate
Leah2015Author
Participant
Oct 21, 2021 7:04 PM UTC

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: 

<a class="nolink IndexKeywordText" href="./xCS-D_new/IaaS/IaaS.htm#1082499">GI-SVC-CEC-CMP</a>

But the dev says that the correct format is: 

<a class="nolink IndexKeywordText" href="./xCS-Google-SD_new/IaaS/IaaS.htm#GI-SVC-CEC-CMP</a>

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

Translate