Skip to main content
Inspiring
August 20, 2024
Question

Cross references in HTML5 are going to the top of the page, rather than the required heading

  • August 20, 2024
  • 2 replies
  • 786 views

On longish pages that have multiple headings within them, I'm finding that if a referenced heading is partway down the page, clicking on the cross ref (from a different page) jumps to the top of the page containing the heading, rather than to the heading's location. This is going to be pretty confusing for users who won't know that the heading they're looking for is further down the page. Does anyone have any advice? I can only assume that we'll have to rejig the heading levels so that each referenced heading is on the top of a page to prevent this happening.

    This topic has been closed for replies.

    2 replies

    Matt-Tech Comm Tools
    Community Expert
    Community Expert
    August 20, 2024

    Best practices in HTML include keeping topics short.

    If your topics are long enough to create this issue, you might consider splitting to new topics on the referenced heading style.

    Have you looked at this option yet in the Publish settings?

    -Matt Sullivan, FrameMaker Course Creator, Author, Trainer, Consultant
    Inspiring
    August 20, 2024

    Hi Matt, yes, that's what I'm assuming might have to happen if this issue persists once we get the latest FM version. I did publish to HTML with the topics split to a lower level and that sorts this out but ideally I'd like to get to the bottom of the problem.

    Matt-Tech Comm Tools
    Community Expert
    Community Expert
    August 21, 2024

    Check the HTML code...I'm expecting you'll find the cross-reference links only to the topic, and not to a named location. You may be able to circumvent this by replacing with a hypertext marker using the Jump to Named Destination option.

    -Matt Sullivan, FrameMaker Course Creator, Author, Trainer, Consultant
    Community Expert
    August 20, 2024

    Hi,

    I do not experience your issue. I just tested this with a cross-reference which points to a heading in the middle of a page of another file. When I convert to HTML5 and click on the cross-reference, the view jumps to this heading and not to the top of the page. The target heading is at the top of the page, when there is lots of text after it. In the middle of the page, when there is only few text after this heading.

    What's your FrameMaker version? I have 17.0.3.

    Have you changed any settings in the Publish pod?

    Best regards, Winfried

    Inspiring
    August 20, 2024

    Good to see my system is still doing annoying things that others can't reproduce :). I'm getting the latest version of FM at some stage in the hopefully not too distant future. Fingers crossed that will sort this out. 
    I've made lots of edits in the Publish pod but I can't think which one would affect this.

    Community Expert
    August 20, 2024

    What's your FrameMaker version? Can  you check this in Help | About?

    I also do not know, which setting in the Publish pod could cause this.

    You could create a new STS file and create a a dummy file and convert this to HTML 5. However, then you have to know where your STS file is, so that you can switch back!