readthedocs / sphinx_rtd_theme

Sphinx theme from Read the Docs
https://sphinx-rtd-theme.readthedocs.io/
MIT License
4.74k stars 1.73k forks source link

Sidebar doesn't display properly in NetSurf #1257

Open ghost opened 2 years ago

ghost commented 2 years ago

godot_netsurf

Calinou commented 2 years ago

For reference, https://docs.godotengine.org/en/stable/ uses some custom CSS and JavaScript: https://github.com/godotengine/godot-docs/tree/master/_static

On the other hand, https://docs.godotengine.org/en/3.0/ uses vanilla sphinx_rtd_theme, so I would recommend starting there for troubleshooting.

nienn commented 2 years ago

sphinx_rtd_theme does not officially support NetSurf either but this is something we could want to fix if there's an easy fix to be found. Given the small NetSurf user base however, this is probably not something where we'll invest a lot of time or risk maintaining.

ghost commented 2 years ago

one half of the fix can be accomplished by simply removing JS code, sidebar can work without JS, for reference: https://netbsd.org/ https://openbsd.org/ https://dragonflybsd.org/

the other half has to do something about spoilers because netsurf doesn't support them, I guess it's ok to leave it as is: expand the list after the link is clicked

nienn commented 2 years ago

one half of the fix can be accomplished by simply removing JS code, sidebar can work without JS

Removing JS from the sidebar is probably something we can look forward to on one of the two next theme major releases.