| {# Renders the global document toctree on every page (including the | |
| landing page) with pydata-sphinx-theme's collapsible chevrons. | |
| The stock sidebar-nav-bs.html starts at the current section and is | |
| stripped from the sidebar list by suppress_sidebar_toctree() on the | |
| root page (no parent section). Using generate_toctree_html with | |
| startdepth=0 renders the whole tree from root with the bootstrap | |
| classes the theme's JS uses for expand/collapse toggles. Naming the | |
| template "sidebar-globaltoc" sidesteps the suppress filter, which | |
| matches on "sidebar-nav-bs.html" specifically. #} | |
| <nav class="bd-docs-nav bd-links" aria-label="{{ _('Section Navigation') }}"> | |
| <p class="bd-links__title" role="heading" aria-level="1">{{ _("Section Navigation") }}</p> | |
| <div class="bd-toc-item navbar-nav"> | |
| {# collapse=False so nested <ul>s render into the DOM for every | |
| branch; the theme's JS then adds the expand/collapse chevrons | |
| on top. show_nav_level is driven by theme_show_nav_level (set | |
| in conf.py) so callers can adjust how deep the sidebar opens | |
| by default without editing this template. #} | |
| {{- generate_toctree_html( | |
| "sidebar", | |
| startdepth=0, | |
| show_nav_level=theme_show_nav_level | int, | |
| maxdepth=theme_navigation_depth | int, | |
| collapse=False, | |
| includehidden=True, | |
| titles_only=True | |
| ) | |
| -}} | |
| </div> | |
| </nav> |