Hei,
we are currently working on implementing context-senstive help. Our designers came now up with the idea that context-sensitive help shall jump to a certain section in a topic. And I struggle with this challenge as it seems that there is no out-of-the-box solution for this.
Example:
A long and quite complex dialog X. The dialog has several "sections" A, B and C.
Each section (A, B and C) shall now have an own help button.
In Online Help, these sections are all in ONE single topic, all as drop-down texts. This should not be changed for online-help.
The only way I found out how this could possibly be implemented, is to copy the sections as micro content and then create Help IDs for the micro content. But this means that I would have to maintain the content twice: In the standard topic AND as micro content.
Maybe, I could create bookmarks in addition to the help ID and the developer simply adds both to the code? But I don't know if this works.
Has anyone of you ever had a similar challenge and could share their solution with me?
Context-sensitive help
Context-sensitive help
You do not have the required permissions to view the files attached to this post.
-
- Sr. Propeller Head
- Posts: 247
- Joined: Thu May 24, 2018 3:11 pm
- Location: Queensland, Australia
Re: Context-sensitive help
Just thinking out loud...
Could the content for each section be a snippet? Then you place the snippet into the overall help topic, and also create separate individual topics for each section containing the same snippet. The GUI calls the individual help topics, the help lists the overall topic and the content is maintainable in a single location.
Rob
Could the content for each section be a snippet? Then you place the snippet into the overall help topic, and also create separate individual topics for each section containing the same snippet. The GUI calls the individual help topics, the help lists the overall topic and the content is maintainable in a single location.
Rob
Re: Context-sensitive help
It's been a long time, but I feel like it used to be possible to map a context id to a bookmark within a topic? You can definitely assign multiple map ids to a single topic.
Re: Context-sensitive help
Yep, as Psider suggested, Flare already supports this - just add a bookmark to the heading, and in the alias editor you can select the bookmark in the topic.
Re: Context-sensitive help
Yes, you are right Dave Lee and Psider. Thanks for the tip. A little hidden this feature. And strangely enough I didn't find this in Flare's help.
Thank you very much!!!
Thank you very much!!!
-
- Senior Propellus Maximus
- Posts: 3669
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Context-sensitive help
Test, though. A few releases of Flare back (going back several years), one of my clients and I observed that the CSH calls to the bookmarked headings did not work. That failure persisted for several Flare releases. I don't recall if MadCap eventually fixed the bug. So, run some tests to make sure you get the results you seek.
Nita
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!