{% extends "base.html" %} {# OpenAPI Reference Section Index Template Renders an OpenAPI section index page showing subsections and endpoints 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 #} {% include 'partials/page-hero.html' %} {# Article Content - autodoc skeleton #}
{# Header #}

{{ section.title if section else 'API Reference' }}

{% if section and section.params.description %}

{{ section.params.description | first_sentence }}

{% elif section %}

Browse {{ section.name }} resources and endpoints.

{% else %}

Browse API resources and endpoints.

{% end %}
{# Quick Stats #}
{% if section and section.subsections %} {{ section.subsections | length }} Resources {% end %} {% set endpoint_pages = (section.sorted_pages if section else []) | selectattr('metadata.element_type', 'defined') | list %} {% if endpoint_pages %} {{ endpoint_pages | length }} Endpoints {% end %}
{# Subsections (Resource Groups) - Card Grid #} {% if section and section.sorted_subsections %}

Resources

{% for subsection in section.sorted_subsections %} {% 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 }} resource

{% end %}
{% end %}
{% end %} {# Endpoint Pages - Card Grid #} {% set endpoint_pages = [] %} {% if section %} {% for page in section.sorted_pages %} {% if page != section.index_page and not (page.source_path is match('.*_index.*')) %} {% set _ = endpoint_pages.append(page) %} {% end %} {% end %} {% end %} {% if endpoint_pages %}

Endpoints

{% end %} {# Empty State #} {% if not section or (not section.subsections and not endpoint_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 %}