Navigation pane scrolling not possible for some sections
ashlymat opened this issue · comments
Contribution guidelines
- I've read the contribution guidelines and wholeheartedly agree
I've found a bug and checked that ...
- ... the problem doesn't occur with the
mkdocs
orreadthedocs
themes - ... the problem persists when all overrides are removed, i.e.
custom_dir
,extra_javascript
andextra_css
- ... the documentation does not mention anything about my problem
- ... there are no open or closed issues that are related to my problem
Description
Our documentation is a collection of md files and we notice that for some sections , the scrolling bar in the navigation pane disappears. When scrolled only main page is scrolling.
Expected behaviour
User should be able to scroll navigation pane for all sections
Actual behaviour
The navigation pane is enabled for some sections:
while it is disabled and not scrollable for some sections:
Steps to reproduce
- Go to our documentation https://www.project-piper.io
- Click on section "Library Steps"
- Click on the step "abapEnvironmentAssemblePackages"
- Try to scroll left pane to look for more steps below it
- This will scroll only the main page but not the navigation pane
Note: This is seen to happen for most of the steps and the only way to come out is to click on other sections (For eg., Extensibility section) and come back to "Library steps".
Also this does not seem to happen for other sections or some sections inside "Library steps"
The only difference I see is with respect to TOC. The sections which are not working seem to have lot of TOC.
Package versions
- Python: 3.10.5
- MkDocs: 1.3.0
- Material: 8.3.6
Configuration
https://github.com/SAP/jenkins-library/blob/master/documentation/mkdocs.yml
System information
- Operating system: Mac OS
- Browser: Safari
Thanks for reporting. What you're observing is a symptom of Material for MkDocs not being able to fully initialize. You're using an outdated configuration for pymdownx.tabbed
. When migrating to a new major version, please always check the migration guide and make sure to apply all necessary changes, respectively this one.