{# We redefine for "basic/layout.html" to add a default `data-theme` attribute when # a default mode has been set. This also improves compatibility when JavaScript is disabled. #} {% set html_tag %} {% endset %} {%- extends "basic/layout.html" %} {%- import "static/webpack-macros.html" as _webpack with context %} {# Metadata and asset linking #} {# Create the sidebar links HTML here to re-use in a few places #} {# If we have no sidebar links, pop the links component from the sidebar list #} {%- set sidebar_nav_html = generate_toctree_html("sidebar", show_nav_level=theme_show_nav_level|int, maxdepth=theme_navigation_depth|int, collapse=theme_collapse_navigation|tobool, startdepth=0, includehidden=True, titles_only=True) -%} {% if sidebar_nav_html | length == 0 %} {% set sidebars = sidebars | reject("in", "sidebar-nav-bs.html") | list %} {% endif %} {# A flag for whether we include a secondary sidebar based on the page metadata #} {% set remove_sidebar_secondary = (meta is defined and meta is not none and 'html_theme.sidebar_secondary.remove' in meta) or not theme_secondary_sidebar_items %} {%- block css %} {# The data-cfasync attribute disables CloudFlare's Rocket loader so that #} {# mode/theme are correctly set before the browser renders the page. #} {# https://github.com/pydata/pydata-sphinx-theme/pull/1045 #} {{ _webpack.head_pre_assets() }} {{ _webpack.head_pre_icons() }} {{- css() }} {{ _webpack.head_js_preload() }} {%- endblock css %} {%- block extrahead %} {%- endblock extrahead %} {% block body_tag %} {# set up with scrollspy to update the toc as we scroll #} {# ref: https://getbootstrap.com/docs/4.0/components/scrollspy/ #} {# A button hidden by default to help assistive devices quickly jump to main content #} {# ref: https://www.youtube.com/watch?v=VUR0I5mqq7I #} {%- endblock %} {%- block content %} {# checkbox to toggle primary sidebar #} {# Checkboxes to toggle the secondary sidebar #} {# A search field pop-up that will only show when the search button is clicked #}

{% include "../components/search-field.html" %}

{%- if theme_announcement -%} {% include "sections/announcement.html" %} {%- endif %} {% block docs_navbar %} {% endblock docs_navbar %}

{# Primary sidebar #} {# Using an ID here so that the skip-link works #}

{# Main content area #} {% block docs_main %}

{# Article header #}

{% include "sections/header-article.html" %}

{# Article content #} {% block docs_body %} {# This is empty and only shows up if text has been highlighted by the URL #} {% include "components/searchbox.html" %}

{% block body %}{% endblock %}

{% endblock docs_body %} {# Article Footer #} {% if theme_show_prev_next %} {% endif %}

{# Secondary sidebar #} {% block docs_toc %} {% if not remove_sidebar_secondary %} {% endif %} {% endblock docs_toc %}

{% endblock docs_main %}

{# Scripts placed at the end of the page to cut down on time to first content #} {%- block scripts_end %}{{ _webpack.body_post() }}{%- endblock scripts_end %} {%- endblock content %} {# Footer #} {%- block footer %} {%- endblock footer %} {# Silence the sidebars and relbars since we define our own #} {% block header %}{% endblock %} {% block relbar1 %}{% endblock %} {% block relbar2 %}{% endblock %} {% block sidebarsourcelink %}{% endblock %}