Skip to main content
S
SRHVines
Known Participant
January 21, 2022
Question

RH2020: TOC Browse Sequence Not Displaying in Published Responsive HTML Help

  • January 21, 2022
  • 7 replies
  • 703 views

When publishing in RH 2015, the navigation path from the TOC displayed in the topics as shown below. Our users were able to click in the sequence to move back.  

 

In our RH 2020 project, I created a Browse Sequence from the TOC and assigned it in the Output Preset. Publishing with the Azure Blue skin, it added left and right arrows that seem to move randomly through topics. The actual clickable sequence isn't displayed. I've searched but am not finding settings for this. Can someone suggest a solution?  

 

Thanks.

 

    This topic has been closed for replies.

    7 replies

    A
    Amebr
    Community Expert
    January 25, 2022

    For the missing space, it's probably in the properties for the placeholder. To access it, open the master page, click inside the breadcrumbs placeholder, then use the html tag navigator at the top of the topic to select the "Breadcrumbs" entry. 

     

    Once you've selected the correct tag, you'll see the Breadcrumbs properties in the General section. Probably the Separator field doesn't include spaces on either side of the '>'

     

    Note: This screenshot is from RH2019. The wording and user interface is a little different in RH2020 but the general areas are the same (give or take the use of icons instead of understandable words).

     

     

     

    For the hyperlinks, RH2020 might allow you to set the formatting through the properties panel - I think this might be one area that has changed from RH2019. Check through the available fields to see if you can find something that references 'a' or 'hyperlink'. You might be able to use the arrow key to move through the characters displayed in the placeholder until you find a 'Type' of 'hyperlink' or something. (If you click immediately to the right of '>', for example, you will see that the 'Type' changes to 'separator'.)

     

    If not, then you will need to use the browser Developer Tools to inspect the output and find the correct style to add to your topic stylesheet. If you can't find anything in the user interface (and Peter doesn't have any suggestions when he comes online) then I can show you an example from RH2019 Responsive HTML5 output that might help you locate the correct style in your outut.

    S
    SRHVinesAuthor
    Known Participant
    January 26, 2022

    We were able to add spaces before and after ' > ' in the Separator field within the Master Page properties panel.  These updated the source and added the spaces in the generated Help. Haven't figured out how to show the steps as clickable links as of yet.  

     

    Master Page > Breadcrumbs > Separator

    Generated Help Build

     

    A
    Amebr
    Community Expert
    January 25, 2022

    Lol. I just repeated my test of placing the breadcrumb placeholder in the body section in RH2019 New UI and this time it didn't work. I love when tests behave differently. 😛

     

    So hopefully adding the breadcrumb in the header section will work correctly for you.

    S
    SRHVinesAuthor
    Known Participant
    January 25, 2022

    It did at that and I thank you for the coaching. Noticing some formatting differences between the versions.

     

    In RH 2015, the steps in the breadcrumb path were underlined and had spaces between them: ' > '. This made it more obvious that they were separate and clickable. Any chance that there's a setting for that in 2020?

     

    2020 - after Home, the steps are separated by '>' without spaces.

     

    2015: each step is separated by space > space and the steps are underlined. 

    A
    Amebr
    Community Expert
    January 25, 2022

    Do you have the latest version of RH2020? At the time of writing it's Update 7.

     

    If you have the first release (2020.0) then the Help > Updates function doesn't work and you'll need to download the patch manually (once you install the patch, Help > Updates will work for subsequent updates. You can download the patch here: https://helpx.adobe.com/robohelp/kb/robohelp-downloads.html

     

    Also, try adding the breadcrumbs placeholder in the header section of the master page (click the Header icon in the toolbar). In RH Classic, it needed to be in the header, otherwise it would only appear for new topics, not existing topics. This doesn't appear to be the case in RH2019 New UI (that is, I added it in the body section and it appeared in an existing topic when I generated the output). However, maybe they reverted the behaviour in RH2020.

    S
    SRHVinesAuthor
    Known Participant
    January 25, 2022

    Yes, we updated from 2020.0 to 2020.6.76 on January 10th. That took us to .4 and then we used the Help > Check for Updates tool to move up to .6.  At some point during those operations, a number of our topics were dumped to 0 bytes and I had to recreate the content. 

     

    This afternoon I updated to 2020.7.46.  Will try repositioning the breadcrumbs placeholder in the master

    page and see if it makes a difference.  

     

    thx 

     

     

    Thanks. 

    Peter Grainge
    Peter Grainge
    Community Expert
    January 24, 2022

    Have you selected the master page in your preset?

    ________________________________________________________
    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    S
    SRHVinesAuthor
    Known Participant
    January 24, 2022

    Yes, I have.  Is it problematic that the master page is First_Topic.htt and I also have a First_Topic.htm that is the default topic in the preset?

     

    Preset for Psych Advantage build

    Add an Appointment topic showing Master Page connection. Note that Welcome is topic title 'Welcome' and File Name 'First_Topic.htm'.

     

    Generated Psych Help showing Add an Appointment topic - no breadcrumbs

    Peter Grainge
    Peter Grainge
    Community Expert
    January 24, 2022

    I think what is happening is that each topic has information telling it what is previous in the browse sequence and it only allows one topic. For example, the sequence is:

     

    Topic One

    Topic Two

    Topic Three

    Topic Four

    Topic Five.

     

    Topic Two knows it has to jump to Topic One. Your problem is that if you repeat Topic Two say before Topic Five in the sequence, it jumps to Topic Two and when the user clicks again, Topic Two knows Topic One is next. It has no knowledge that it is a second instance in the sequence.

     

    I think the only way you will get around this is to create a redirect topic as described on my site in the merged help topics. Add the redirect

     

    You would add the redirect topic to the TOC to get it in the build and add it to the browse sequence instead of a second instance of Topic Two. The redirect would be set up to go to Topic Four. When the user clicks the redirect it will open Topic Four as required.

     

    I think either RoboHelp should not allow you to use a topic twice to force you to use the above topic (which I think was the case in Classic versions) or code it to work with more than one instance of a topic.

    ________________________________________________________
    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    S
    SRHVinesAuthor
    Known Participant
    January 24, 2022

    Thank you for the information.  

    If I could get the breadcrumbs to work, I could forego the next/back topic navigation. I do have a master page and the breadcrumbs property was no longer visible on it after the 2015>2020 ugprade.  

    I used the placeholder icon to re-add it and generated the project. May not have added it properly.  I'm not seeing the breadcrumbs on topics assigned to the master page.

    Master page:

    This topic is assigned to the Master page but is not displaying the breadcrumbs. 

    Opened in Edge 

    A
    Amebr
    Community Expert
    January 23, 2022

    The feature in your last image is called 'breadcrumbs'. You would add the breadcrumbs placeholder to your master page (if you're not using a master page already, I recommend creating one, otherwise you would need to add the breadcrumbs placeholder to every topic.)

    Peter Grainge
    Peter Grainge
    Community Expert
    January 22, 2022

    It helps if you use the photo icon to insert images within the post. Seeing an image inline with the text makes it easier for anyone answering or viewing the post.

     

    When you create a browse sequence from the TOC it should be in TOC order. You can see the sequence in the Browse Sequence editor, left panel.

     

    Please show us an example of where the buttons are going to a different topic than shown in the browse sequence.

    ________________________________________________________
    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    S
    SRHVinesAuthor
    Known Participant
    January 23, 2022

    Thank you for the posting tip.  I think I see what is happening.  When I click the back arrow, instead of moving to the previous topic in the current TOC location, it's moving back from the first instance of the topic in an earlier section of the TOC. This is consistent with how the Browse Sequences present.  This topic appears in multiple sections in the TOC - this is the list of topics from the first book it appears in. 

    I started from Module: Patient > Exam (Medical Records) > SQL Worklists.  The previous topic is Shortcuts and Right Click Options

    Back arrow took me to the topic Customize Query Report which is above SQL Worklists in the TOC > Module: Data Mining > SQL Worklists. This is consistent with the first time the topic is listed in the Browse Sequences. 

    We're trying to replicate the option we had in RH 2015 where the user could click on a link in the navigation path to back up to the previous level in the TOC.  In this instance, back to any place in the sequence Home > Module: Patient > Exam (Medical Records).  Maybe Browse Sequences is not the tool for this - or it's no longer possible? 

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