exeGesIS-SDM / exegesis-docs-website

Website built with cloudscribe components for Exegesis SDM documentation
0 stars 0 forks source link

Navigating to anchors within pages results in the anchor position disappearing behind the header #5

Open CrispinF opened 4 years ago

CrispinF commented 4 years ago

@SimonAnnetts noted:

One thing I have noticed about having the floating header bar always at the top of the page on the docs website is that now anchor links don't work as expected.

Try this link:

https://docs.esdm.co.uk/librarylink/configuring-librarylink-for-consultants#configuration-files

You'll see that you have scroll back up to actually see the start/heading of the section. It breaks things like table of contents at the top of the document.

SimonAnnetts commented 4 years ago

this looks like it's been solved here: http://jsfiddle.net/ianclark001/rkocah23/

There are pure CSS solution available too, but all have some issues with certain viewport sizes etc.

CrispinF commented 4 years ago

I'm personally not a huge fan of linking to anchors within a page... if something is significant enough to link to, perhaps it should be a page in its own right? So maybe we can just sidestep this issue?

SimonAnnetts commented 4 years ago

So if I want to link from say the 'Migrating from LL4 to LL5 page', to a specific part on the 'Configuring LL5' page that deals with how to set one configuration option, I must either make a separate page for that or duplicate the section in the original page?

CrispinF commented 4 years ago

@SimonAnnetts I'll look to fix the issue. But unless pages get really long it's normally fine to link to the page and mention the section. The longer the page obviously the stronger the case for links to anchors.