{# Custom sidebar template that always shows navigation — even on orphan pages
   (e.g., Doxygen sub-pages generated by doxysphinx).

   When a page is part of the toctree, the default navigation is rendered.
   When a page is an orphan (no toctree context), we fall back to the root
   toctree so the user still sees the top-level navigation — replicating the
   Read the Docs theme behaviour.
#}
<nav class="bd-docs-nav bd-links" aria-label="Section Navigation">
  {% set nav = toctree(maxdepth=theme_navigation_depth|default(4), collapse=true, includehidden=true, titles_only=true) %}
  {% if nav | trim %}
    {{ nav }}
  {% else %}
    {# Orphan page: render root toctree as fallback #}
    <p class="bd-links__title" role="heading" aria-level="1">Navigation</p>
    {{ toctree(maxdepth=1, collapse=true, includehidden=true, titles_only=true) }}
  {% endif %}
</nav>