Strange TOC Behavior

This forum is for all Flare issues related to the HTML5, WebHelp, WebHelp Plus, and Adobe Air Targets

Strange TOC Behavior

Postby TechWriter85 on Tue Nov 12, 2019 7:58 am

Hi, all.

I am working on a help system that has a repetitive structure. Many H1 topics contain H2s that provide identical information, such as "Activity Log." The description of this tab remains constant throughout the help system.

Therefore, we have one "Activity Log" topic (.htm file) starting with an H2, and I have copied that .htm into the TOC repeatedly, once under each H1. Here is an example:

SampleARMSTOC.png


(BTW, for some reason, the TOC uses the filenames instead of the topic titles. Suggestions about how to fix it warmly welcomed.)

In the final HTML5 output, the headings appear just as you would expect. When I expand both H1s, I see that "Activity Log" exists underneath both H1s:

CompleteTOC.png


However, if I click Activity Log under BatteryBank_Shortened, the actual topic that opens is the Activity Log topic under CircuitBreaker_Shortened, and the TOC adjusts accordingly:

The reader sees the correct information, but the TOC has jumped around. Surely this will be confusing and unhelpful to any reader who is actually using the TOC for navigation. How do I make it behave like a regular TOC? Thanks!
You do not have the required permissions to view the files attached to this post.
TechWriter85
Propeller Head
 
Posts: 35
Joined: Mon May 13, 2019 6:37 am

Re: Strange TOC Behavior

Postby Dave Lee on Tue Nov 12, 2019 8:28 am

That happens because you have the same topic in multiple locations in your TOC.

To fix it, use the target setting Synchronize navigation elements with TOC entries.

https://help.madcapsoftware.com/flare20 ... ntries.htm

But read the pros and cons, as your URLs will look a lot more complex.
Dave Lee
Master Propellus Maximus
 
Posts: 5749
Joined: Mon Mar 05, 2007 8:33 am
Location: UK

Re: Strange TOC Behavior

Postby TechWriter85 on Wed Nov 13, 2019 12:00 pm

Thank you! That worked perfectly, and the URL issue is not a problem for us.
TechWriter85
Propeller Head
 
Posts: 35
Joined: Mon May 13, 2019 6:37 am


Return to Web-based Outputs

Who is online

Users browsing this forum: No registered users and 2 guests