sphinx_rtd_theme
sphinx_rtd_theme copied to clipboard
readthedocs
Navigation problems with singlehtml output
I have two, possibly related, issues with navigation when generating singlehtml output.
Firstly, when clicking on the top-level entry in the navigation bar, it does not automatically open to display the lower levels. Clicking on the [+] icon does. Clicking on lower level entries does automatically open them.
This is a relatively minor UI annoyance/inconsistency but it seems to also cause a major problem on small screens for mobile devices.
In this case, clicking on the menu icon at the top of the page displays the navigation bar. Clicking on a top-level entry goes to that location but does not close the menu. Worse, the menu icon has disappeared and it is impossible to hide the navigation bar. It seems it is not possible to scroll back to the top of the document.
The contents page can be redisplayed by either refreshing the page or by clicking on the [+] icon next to one of the top-level entries, then selecting a sub-entry. This correctly goes to that heading and closes the menu.
This makes singlehtml output unusable.
Reproducible Project
The attached example with an index file, a couple of content files and a minimal conf.py demonstrates the problem.
Error Logs/Results
The attached image files show:
-
Display for a mobile device with the menu icon
-
Navigation displayed (menu icon still visible)
-
After clicking on an entry (correct location displayed on right of page but hidden by navigation menu)
Environment Info
- Python Version: 3.7.6
- Sphinx Version: 2.4.2
- RTD Theme Version: 0.4.3
Running MacOS Catalina. Checked results in a couple of browsers (Chrome and Safari) with identical results.
