Skip to main content
Inspiring
February 15, 2013
Answered

How do I map context-sensitive UI hooks to Multiscreen HTML5 Help Topics?

  • February 15, 2013
  • 1 reply
  • 1703 views

My company has several products that are webapps, and we link to online help, which opens a context-sensitive topic for every page. We are now redesigning those webapps to be compatible with mobile devices and would like to use Multiscreen HTML5 output for the online help so the online help experience mirrors the webapp UI experience.

In the past, we have programmed simple direct URL links into the UI to link to online help (webhelp output). For example, if we had two pages, Page1 and Page2, these would be the URLs that the Help button in the webapp linked to:

For http://www.mycompany.com/product_name/Page1:  http://www.mycompany.com/robohelp/product_name/index.htm#Page1help.htm

For http://www.mycompany.com/product_name/Page2:  http://www.mycompany.com/robohelp/product_name/index.htm#Page2help.htm

However, with HTML5 output, we will now have four possible destinations from each help button depending on whether the event is initiated from a desktop, Android tablet, iPad, or iPhone/iPod touch:

For http://www.mycompany.com/product_name/Page1: 

http://www.mycompany.com/robohelp/product_name/desktop/index.htm#Page1help.htm

http://www.mycompany.com/robohelp/product_name/android_galaxy_tab/index.htm#Page1help.htm

http://www.mycompany.com/robohelp/product_name/ipad/index.htm#Page1help.htm

http://www.mycompany.com/robohelp/product_name/iphone/index.htm#Page1help.htm

Is there a way using map IDs to program a single URL into my webapp and have RoboHelp choose the correct path to follow based on the device specifications? For example, if Page1help.htm had a Map ID of 1, is there a URL convention similar to http://www.mycompany.com/robohelp/product_name/index_csh.htm#topicID=1 that would work in this context?

I haven't been able to find any support materials from Adobe that explain how to create a context-sensitive mapping under these circumstances.

Any help would be much appreciated.

- Steve Lorenzo

This topic has been closed for replies.
Correct answer Willam van Weelden

Hi,

Please see my article on HTML5 CSH: http://www.wvanweelden.eu/articles/context-sensitivity-multiscreen-html5

You can also use the default RoboHelp API for this. Check your RoboHelp installation folder, in the folder CSH API.

Greet,

Willam

1 reply

Willam van Weelden
Willam van WeeldenCorrect answer
Inspiring
February 16, 2013

Hi,

Please see my article on HTML5 CSH: http://www.wvanweelden.eu/articles/context-sensitivity-multiscreen-html5

You can also use the default RoboHelp API for this. Check your RoboHelp installation folder, in the folder CSH API.

Greet,

Willam

Known Participant
April 24, 2015

Hello,

Our developer is using the default Robohelp API from the CSH API folder and the instructions from your website. He is unable to call the topics with the map id's and is only getting the default topic. He is asking me for the file where the map id's are stored. I thought it was BSSCDefault.h, but I see it is not in the published files. Any ideas of what we could be doing wrong?

Willam van Weelden
Inspiring
April 25, 2015

The map id's in the RoboHelp project are stored in the .h files and the .ali file.

If I have to guess, the map files are probably not included in your output. Open your SSL settings and make sure to select all map files. They are sometimes deselected by default and then your CSH won't work.

Check the settings and supply your developer with a new output. If that doesn't solve it, please post back.