behoppe
commented
1 year ago Recently I have made progress on overall styling by using Sphinx Bootstrap Theme, which I am integrating into a development branch. There are a couple immediate benefits
- It replaces a lot of my ad hoc web design with the sort of "theme" that I wanted to leverage all along. The theme is based on Bootswatch sandstone.
- Out of the box, the theme provides the sort of navbar, sidebar, and footer behavior that we want (in terms of what's fixed and how things scroll etc.)
On the downside, this theme is about 7 years old and uses Bootstrap 3, not Bootstrap 5. No flex-boxes among other things.
Another intriguing possible benefit... Because this is a Sphinx theme, in order to use it, I have encapsulated a dummy installation of Sphinx inside the Eleventy system that defines the site. Right now, I'm just using that to extract styling elements from Sphinx into Eleventy, but there's certainly a possibility that we could put actual content inside the encapsulated Sphinx installation, so that Eleventy can extract that content and display it as part of the overall site. Bottom line: can we maybe combine the benefits of Sphinx documentation management with Eleventy website flexibility?
Issues When I click on an anchor tag (e.g. link to a glossary entry, or something in the left sidebar) then the result is hidden beneath the navbar and I have to scroll up a few lines to see it.
Improvements I should not have to scroll up to see the result.
Additional discussion This issue is a side effect of the
position: fixed;navbar. If I edit the navbar to scroll off the top of the screen, then all the anchor tags work fine.I have spent many hours on this already, and simple examples are not helping. There is some interaction happening in our implementation that still eludes me.