Known Participant

Answered

Hyperlink to Bookmarks - in Context-Sensitive Topics

Forum|Forum|4 years ago
February 8, 2021
17 replies
2381 views

I am using RoboHelp 2019 (going to RH 2020 soon), with a huge help project that has Responsive HTML5 output. Our help is "attached" to our application, and help topics are launched when the user clicks the Help button on a web page in the system. Of course, there's the option to switch to "full context" view when the individual topic is displayed in my Charcoal_Grey layout.

Here's an example of what appears when I click the Help button from within the application (context-sensitive mode):

The problem is that we have many hyperlinks to bookmarks in various places, both within the same topic and within other topics. In the example below, the hyperlink is set to go to the bookmarked "Filtering the Display" steps included above:

However, when I click the hyperlink, it goes to a different place, 2 lines below the bookmark target for "Filtering...".

In the project, these sets of steps (in this example) are bookmarked as below:

This also occurs if I go to any bookmarked place within that topic - section heading or field description.

NOTE: This symptom does NOT occur if I view in "full context" mode - which obviously has a different type of heading in the layout. It works correctly in this "standalone" mode too.

Since these hyperlink-to-bookmark are everywhere in our help system, we need to resolve this. In prior versions, we were using WebHelp, and this issue wasn't happening.

I suspect this is related to our layout setup, but I'm not sure exactly what to try to change. We are not required to continue using Charcoal_Grey. As long as we have a link to switch to "full context" mode for our TOC/Index/Search.

I even thought in looking at the heading that perhaps to change the size of our logo. What controls the "height" of the heading bar for a single topic in context-sensitive mode?

So, I need help!! Perhaps switch back to WebHelp?? A different layout?? Adjustment to a Responsive layout??

Thanks in advance!! I have had great fortune in getting answers from the wonderful expert users here! Hope I have explained this issue clearly enough to understand.

Susan

New UI

This topic has been closed for replies.

Correct answer Amebr

This might work, although it does mean that the link destination ends up a bit lower down the page that normal in full layout view. Also make sure you test extensively in all browsers you need to use. And check it doesn't do anything else funny to the display in the full layout view.

Add it to your css file.

[id]:target:before {
display:block;
content:'';

visibility: hidden;

padding-top:3em;
margin-top:-3em;
}

3em for padding-top and margin-top should be fine for the current default height of the csh header bar, but would need to be changed if Adobe changes it in future, or you modify it yourself, somehow (I don't think it's currently easily accessible, but I haven't checked thoroughly).

Show previous replies

Peter Grainge

Adobe Expert

If it's not a silly question, is there a reason you don't call the CSH topic in full screen mode?

Going back to WebHelp is not an option. There is no webhelp output in 2019 new UI or in 2020. See RH2019 WebHelp Output (grainge.org)

Would it be an option to use a frameless output. Going forward Adobe will be focussing more work on frameless outputs so I recommend considering frameless skins for your project. The calls using URLs are different so you need to discuss that with your developers as you use context sensitive help. I don't know if that solves this problem but there are no frames so the topics alway include the TOC etc.

________________________________________________________
See www.grainge.org for free Authoring and RoboHelp Information

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

F

Freespirit-STAuthor

Known Participant

Thanks, Peter! Not a silly question - I thought of moving it to display in full screen mode when the CSH topic is launched, too! As long as the CSH topic appears in the right topic panel.

Does your site have the exact call we would need to use to display the CSH topic in full screen mode?? You always have the most helpful details on your site!

And I will move us to frameless output in a few weeks, after our release is "out the door".

Also, we will be going to RH 2020 at that point, so we will see about other enhancements.

Take care,

Susan

A

Amebr

Adobe Expert

I hope it works. I use a similar workaround in Classic Multiscreen HTML5, so when I eventually move to New UI and responsive or frameless, I might need this technique depending on what customisations to the skin I can achieve. 🙂

F

Freespirit-STAuthor

Known Participant

I changed it to 6em and the spacing was better. So I think it works, for now! From what I can see. Thank you!!

After listening to what you and Peter are saying, I will definitely work on changing us to frameless output, once we move beyond the release that is finishing up.

A

AmebrCorrect answer

Adobe Expert

This might work, although it does mean that the link destination ends up a bit lower down the page that normal in full layout view. Also make sure you test extensively in all browsers you need to use. And check it doesn't do anything else funny to the display in the full layout view.

Add it to your css file.

[id]:target:before {
display:block;
content:'';

visibility: hidden;

padding-top:3em;
margin-top:-3em;
}

3em for padding-top and margin-top should be fine for the current default height of the csh header bar, but would need to be changed if Adobe changes it in future, or you modify it yourself, somehow (I don't think it's currently easily accessible, but I haven't checked thoroughly).

F

Freespirit-STAuthor

Known Participant

Thank you SO much!! Definitely worth a try - will copy exactly what you have into our CSS.

Will keep you posted! Really appreciate your help here!!!

Susan

Jeff_Coatsworth

Adobe Expert

All the Dev effort seems to being put into Frameless output, so maybe try playing with that? Just make sure your RH2020 is patched up, because they keep making fixes to the conversion routines each patch as people run into situations that they [Adobe] hadn't run across.

Jeff_Coatsworth

Adobe Expert

I would make sure that the RH2020 is updated & then experiment with a COPY of your RH2019 project to see how well it converts & if you have the same issue that you're seeing in the 2019 version of the project.

F

Freespirit-STAuthor

Known Participant

I have a couple much smaller projects, showing same symptom, to experiment with.

For my layout, I don't see a way to make the heading bar thinner in context-sensitive display (individual topic). I would try that so it would show the extra 2 lines. Or, like in our old WebHelp output, no heading bar but the "Show Table of Contents, Index..." link in upper left corner.

Any layout change ideas??

F

Freespirit-STAuthor

Known Participant

Forgot to add here that hyperlinks to other topics - just to the HTM topic, and not a bookmark! - work just fine.

Jeff_Coatsworth

Adobe Expert

What version of RH2019 are you running? Classic or New UI? Are you all patched up?

F

Freespirit-STAuthor

Known Participant

New UI. I believe we have all the patches applied for RH2019. I believe applied 3 patches - are there more I've missed? I can re-apply the last one just to be sure.

F

Freespirit-STAuthor

Known Participant

In our Help > About RoboHelp, it says 2019.0.14

Trying to get to page where I can find and download latest.

Sign up

To post, reply, or follow discussions, please sign in with your Adobe ID.

Sign in to Adobe Community

To post, reply, or follow discussions, please sign in with your Adobe ID.

Scanning file for viruses.

This file cannot be downloaded