common-workflow-language / user_guide

The CWL v1.0 - v1.2 user guide
http://www.commonwl.org/user_guide/
Other
40 stars 67 forks source link

Fix empty section navigation sidebar and reorganize templates a bit #471

Closed kuanyili closed 2 months ago

kuanyili commented 2 months ago

The sidebar generation logic in the PyData Sphinx Theme was altered, causing the navigation sidebar here to become consistently displayed but always empty.

See https://github.com/pydata/pydata-sphinx-theme/commit/fcde0061fa9a44097230854f0beed1f228d23f6f and https://github.com/pydata/pydata-sphinx-theme/commit/d4f888ec5e63628d6e3c5bf81b6b689a20b3927c.

The sidebar-nav-bs.html override was initially added to address a responsive design issue, which has now been effectively resolved by the upstream. Let's remove the override to avoid future breakage.

sidebar_includehidden is set to False to get rid of the sidebar when its content is empty.

Also reposition the project links, switch to an approach that aligns more with PyData Theme design philosophy.