Skip to main content
STLRGA
STLRGA
Inspiring
March 8, 2018
Answered

Display Navigation Pane when linking topics Between Different Outputs

  • March 8, 2018
  • 1 reply
  • 1342 views

I am pretty sure I know the answer to my inquiry from some other posts which is this not do-able, but I just want to check to make sure I have not missed something. I want to be able to link directly from one topic to another, but each topic is generated from different HTML5 output settings with different conditional build tags specified. Each output is generated/published to different folders and each one has its own TOC, Glossary and Index.

The reason I want to do this is for multiple languages. Users will open the help in the default English version. If they open a specific topic that is translated (in my case to Japanese), there will be a link in the content of English version topic that says “日本語版を見る”. When they click the link, the topic will “switch over” to the Japanese translated version of the topic, including the translated TOC, Glossary, etc.

I have been able to mess with the link and it will open the translated topic, but it does not automatically show the TOC, title (frame/labels translated). Instead, I get the header that says, something like “Click here to view topic in content page”. When that is clicked, it is all good at that point, but I do not want end Users to be exposed to this extra step. This is the same behavior that occurs when opening a specific topic without going through the starter topic (usually index.htm) first. Is there anything I can do to the code for the link or whatever to get the topic to open automatically with its corresponding TOC, title, etc.?

I am using RoboHelp2017, HTML5 Responsive Indigo based output and not doing anything with CSH or merged projects.

This topic has been closed for replies.
Correct answer DirkD007

The one that currently has the value you see.

Sorry but I'm not at a RoboHelp machine to check.

See www.grainge.org for free RoboHelp and Authoring information.

@petergrainge


I found the solution to my header problem in the following article. Apparently there's an issue when opening an HTML5 RH 2015 project with Rh 2017 and then generating help. Thanks for your tip on the LNG file. That pointed me in the right direction.

Upgrade RoboHelp 2015 responsive HTML5 layout to RoboHelp 2017

1 reply

Peter Grainge
Community Expert
Peter GraingeCommunity Expert
Community Expert
March 8, 2018

If I have understood you correctly, what you are seeing is what you will get if you click this link.

www.grainge.org/pages/authoring/rh_tour/rh2017_new/rh2017_new_responsive_HTML5_layouts.htm

What you want is what you would get with this link.

www.grainge.org/pages/authoring/rh_tour/index.htm#t=rh2017_new%2Frh2017_new_responsive_HTML5_layouts.htm

Note the difference is the second link is calling the start page and then going on to the required page. The user only sees the target.

Now how to get the link in your project.

I set up a project on the same drive as my local copy of the RoboHelp Tour.

In one of the topics I selected some text and created a link using the File option in the dialog.

I then browsed to the topic above in the source files, not the SSL output.

The link will look wrong but OK your way back out, then double click the link you have just created and it will look like this.

../RoboHelpTour/rh2017_new/rh2017_new_responsive_HTML5_layouts.htm

If you now generate the project and put the two outputs at the same level on the server, that relative path should hold good.

I'm sure there are other ways of doing it using CSH but that seems to be what you want. Any easy way to create links from one output to another that will open the help with TOC etc.

BTW. The text Click here to view topic in content page can be changed in the project's LNG file to whatever you want.

See www.grainge.org for free RoboHelp and Authoring information.

@petergrainge

Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
STLRGA
STLRGAAuthor
Inspiring
March 8, 2018

Hi Peter,

I followed your instructions and it was not quite working for me, although almost. The link was opening the navigation pane, but only showing the content of the index.htm file, not the specific topic I wanted. After checking the urls of a working project that was output with HTML5, I noticed it had /topic.htm#t= instead of /index.htm#t=. Based on that, I tried swapping out /index.htm#t= with /topic.htm#t= in the link and for some reason that worked. It does not seem to make sense because I have index.htm defined for the start page in the output settings. topic.htm just seems like something the output is creating, I do not see it in my authoring files?

Thanks so much for helping me get this figured out. I was just about ready to throw in the towel on this.

Terms & ConditionsAccessibility statement
Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices