{% extends "base.html" %} {# API Reference Section Index Template Renders an API section index page showing subsections and modules using a card-based layout. Extends base.html to inherit theme navigation. Uses autodoc.css for all styling. This template receives: - section: Section object for the API section - config: Autodoc configuration - site: Site instance #} {% from 'partials/navigation-components.html' import breadcrumbs, page_navigation, toc %} {% block content %} {# Three-column documentation layout #}
{# Left Sidebar: Navigation #} {# Main Content #}
{# Page Hero: Breadcrumbs + Title + Description + Stats #} {% from 'partials/page-hero/_macros.html' import hero_section %} {{ hero_section(section, page, {}) }} {# Article Content - autodoc skeleton #}
{# Build module list once for cards #} {% set module_pages = [] %} {% if section %} {% for page in section.sorted_pages %} {% if page != section.index_page and not (page.source_path is match('.*_index.*')) %} {% set _ = module_pages.append(page) %} {% end %} {% end %} {% end %} {# Subsections (Packages) - Card Grid #} {% if section and section.sorted_subsections %}

Packages

{% for subsection in section.sorted_subsections %} {% if subsection.name %} {% set desc = subsection.metadata.description | default('') | first_sentence %} {% set child_count = (subsection.subsections | length) + (subsection.pages | length) %}
{{ icon("folder", size=20, css_class="icon-muted") }} {{ subsection.name | title }}
{% if desc %}

{{ desc }}

{% else %}

{{ subsection.name | title }} package

{% end %}
{% end %} {% end %}
{% end %} {# Module Pages - Card Grid #} {% if module_pages %}

Modules

{% end %} {# Empty State #} {% if not section or (not section.subsections and not module_pages) %}
{{ icon("file-text", size=48, css_class="icon-muted") }}

No documentation available in this section yet.

{% end %}
{# Page navigation (prev/next) at bottom #} {{ page_navigation(page) }}
{# Right Sidebar: Contextual Graph + TOC + Metadata #} {% include 'partials/docs-toc-sidebar.html' %}
{# Mobile sidebar toggle button #} {# Sidebar overlay for mobile #} {% end %}