blob: f4aa2051f1c18af8174bf7cfd13e5f51df4fd287 [file]
{# 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>