Sticky menu hides linked content in the documentation

[G.]

Hi.

I saw in the new style for the documentation, and when you click on an anchor link the page will scroll accordingly, but the content will be hidden behind the top menu. Pretty annoying IMO.

For example on the RenderTarget page, click on the 2nd mapCoordsToPixel public member function. Or directly click here. I've included a screenshot with added transparency to demonstrate the problem.

Solution may be the scroll-padding-top or scroll-margin-top CSS properties? (not sure what the difference is)

[eXpl0it3r]

Yeah, I'm aware. Haven't really investigated as much, but will take a look at the mentioned CSS properties. On mobile it actually works pretty well, so I have to make sure to only fix it for certain screen sizes.

[Hapax]

I noticed this too. Started getting used to automatically scrolling up. If you fix this, I'll be scrolling away from it!

But do, please

[eXpl0it3r]

You guys motivated me to look into it and I believe, I've managed to fix it. Let me know if you find cases/resolutions where it doesn't work.

I noticed this too. Started getting used to automatically scrolling up. If you fix this, I'll be scrolling away from it!

You mean like:

[Hapax]

Haha; that's fantastic!

[G.]

Nice

[Hapax]

Just since this was brought up, I should mention that there are a couple of errors here and there in the documentation, whether it be not updated to 3 or may have been updated to 3 before it changed? I'll try to make a note of them when I spot them again.

Also, could we *please* have a dark theme for the documentation?

[eXpl0it3r]

Just since this was brought up, I should mention that there are a couple of errors here and there in the documentation, whether it be not updated to 3 or may have been updated to 3 before it changed? I'll try to make a note of them when I spot them again.

Yeah, please do! We tried our best to update everything, but there isn't an easy way to automatically check all of it, so we try to fix it as people report it.

Also, could we *please* have a dark theme for the documentation?

It's not an easy thing to do, because it mixes the doxygen generated HTML with the MkDocs navigation in a manual way and someone would need to write a whole style sheet for the doxygen version for a dark mode and somehow hook it up with the MkDocs switching etc.

If anyone has an idea how to better integrate doxygen docs into a MkDocs site,  I'd be interested to see it. The plugins I've tried so far, lead in my opinion to a worse result.