search

nasa-fornax / fornax-demo-notebooks

Demo notebooks for the Fornax project
https://nasa-fornax.github.io/fornax-demo-notebooks/
BSD 3-Clause "New" or "Revised" License
8 stars 19 forks source link

BUG: Top level headings are missing from TOC #295

Closed bsipocz closed 2 months ago

bsipocz commented 2 months ago

E.g both Tutorial Notebooks and User Documentation should have been listed in the left hand side, but that heading level has been skipped in the TOC?

Screenshot 2024-07-31 at 19 50 29
bsipocz commented 2 months ago

Well, unfortunately this seems to be a deep rabbit hole (see https://github.com/sphinx-doc/sphinx/issues/2103 and references therein) without an obviously good solution.

I tried to use :caption: within the toctree directive, but as opposed to the headings, those don't come with anchors, and also use a level or two smaller fonts.