FrameMaker 2022 - HTML5 Generation: wrong synchronization between the TOC and the HTML5 content

[bernd_steffens]

When I generate a HTML5 help, I  use topic sequences to scroll back and forth between the topics. The help project is quite large, i.e. it contains about 2400 A4 pages. When scrolling, the TOC entries do not match the currently displayed help topics. There is an offset between the topic order and the TOC order.

Can anybody give me a hint how to avoid or how to solve this problem?

[Jeff_Coatsworth]

I'm not familiar with the term "topic sequences" in HTML5 output - are you talking about a breadcrumb browse sequence? What patch level of FM2022 are you running?

[bernd_steffens]

Hi,
with the term "Topic Sequences" I meant "Browse Sequences". Sorry that I used the wrong term, but I normally use the German versions of FrameMaker and RoboHelp.


Best Regards

Bernd Steffens



________________________________

Confidentiality note:
The information in this email and any attachment may contain confidential and proprietary information of Heidelberger Druckmaschinen AG and/or its affiliates and may be privileged or otherwise protected from disclosure. If you are not the intended recipient, you are hereby notified that any review, reliance or distribution by others or forwarding without express permission is strictly prohibited and may cause liability. In case you have received this message due to an error in transmission, we kindly ask you to notify the sender immediately and to delete this email and any attachment from your system.

[Jeff_Coatsworth]

I've not heard of anyone experiencing a browse sequence getting out of synch with the TOC - if you look at the output locally, does it happen there? Or is this something you only see happening when it's been loaded to a web server?

[bernd_steffens]

If I use the browse buttons (1) to switch through the browse sequence, the wrong TOC entry (marked with the yellow marker) is displayed. Instead, the correct TOC entry should be the item within the red frame. 

[Jeff_Coatsworth]

If you were doing this through RoboHelp, I would have suggested trying another skin template/preset theme to see if it moved along with the browse sequence; but with FM, I'm not sure you get much of a choice in using different skins for the HTML5 output.

[Winfried Reng]

Hi,

What do you mean with "do not match"?

Does this mean that a different page is opened?

Or do you have a single page with several topics, and the TOC entry does not jump to the correct topic on this page?

Or does the TOC entry jump to a different page?

Best regards, Winfried

[davidcfrye]

While I'm not familiar with your exact issue, I have had all sorts of trouble the last two years with the HTML5 conversion through FrameMaker. Most of the issues we've had centered on special characters being read as part of the code (i.e., it appears that the conversion code is not setup to escape some special characters) or ignored by the code when it shouldn't be. I don't know if that is helpful at all, but you might investigate your content to see how that conversion might be handled. If everything before that sequence you show in your screenshots is NOT out of sync, it stands to reason somewhere in that range something is "different" about the underlying content. Maybe. Good luck!