nih-cfde / training-and-engagement

Materials for the Training and Engagement Website
https://training.nih-cfde.org/
Other
25 stars 10 forks source link

Highlight all levels in left side navigation and disable all tabs feature #320

Closed s-canchi closed 2 years ago

s-canchi commented 3 years ago

Currently we use MkDocs-material theme for the training website. We have nested tutorial structure which can be lost in the left side TOC. Only the selected lesson is highlighted in light blue shade. What we would prefer is for all the top level folders to be highlighted so as to keep track of lesson origin even when the tab is collapsed.

Screenshot below highlights the issue:

Screen Shot 2021-01-29 at 3 58 41 PM

Recent update to the mkdocs-material implements changes the behavior of the navigation.tabs feature which now shows all the tabs on all pages. This is not desirable and we want to only have the lessons in the left side TOC for each selected tab.

Older version (mkdocs-material <=6.1.7)

Screen Shot 2021-01-29 at 4 35 06 PM

Newer version (MkDocs-material >= 6.2.0)

Screen Shot 2021-01-29 at 4 36 35 PM

I have also posted the later issue in the discussion forum in mkdocs-material repo. We want to explore fixes to both issues using some css/html/javacsript tricks. @ctb @ACharbonneau for some help/guidance.

s-canchi commented 3 years ago

Related to #305

s-canchi commented 3 years ago

The all tab render issue will be fixed in Feb release. It stemmed from a conflict coming from a using the custom partial nav file.

jeremywalter commented 2 years ago

done