test mkdocs

This commit is contained in:
2025-02-04 11:08:36 +01:00
parent 9095a88669
commit b06f537d0b
83 changed files with 15901 additions and 3049 deletions

View File

@ -0,0 +1,3 @@
{% macro get_section_index_page_title() -%}
{% if config.extra.INDEX_PAGE_NAV_TITLE %}{{ config.extra.INDEX_PAGE_NAV_TITLE }}{% else %}Index{% endif %}
{%- endmacro -%}

View File

@ -0,0 +1,41 @@
{% import 'macros/side-nav/section-index-page-title.j2' as index_helper with context %}
{% macro get_base_class( nav_item ) -%}
{% set ns = namespace(class="terminal-mkdocs-side-nav-item", is_active_index=false) %}
{% if nav_item.active %}
{%- set ns.class = ns.class ~ "--active" -%}
{% endif %}
{% if "navigation.side.indexes" in features and nav_item.title == index_helper.get_section_index_page_title() %}
{# if nav_item is a index page, check to see if any of its' siblings are active) #}
{% for index_sibling in nav_item.parent.children %}
{% if index_sibling.active %}
{% set ns.is_active_index = true %}
{% endif %}
{% endfor %}
{% if ns.is_active_index %}
{%- set ns.class = ns.class ~ "--active" -%}
{% endif %}
{% endif %}
{{ ns.class|trim }}
{%- endmacro -%}
{# 'terminal-mkdocs-side-nav-section-no-index' css class used to indicate a non-clickable folder #}
{% macro get_class( nav_item ) -%}
{% set ns = namespace(class="") %}
{%- set ns.class = get_base_class( nav_item ) -%}
{% if nav_item.children %}
{% if "navigation.side.indexes" not in features %}
{%- set ns.class = ns.class ~ " terminal-mkdocs-side-nav-section-no-index" -%}
{% else %}
{% if nav_item.children|selectattr("title", "eq", index_helper.get_section_index_page_title() )|list|length == 0 %}
{%- set ns.class = ns.class ~ " terminal-mkdocs-side-nav-section-no-index" -%}
{% endif %}
{% endif %}
{% endif %}
{{ ns.class|trim }}
{%- endmacro -%}

View File

@ -0,0 +1,23 @@
{% macro index_item( nav_item, class ) -%}
{% if nav_item.active %}
<span {% if class %}class="{{ class }}"{% endif %}>{{ nav_item.parent.title }}</span>
{% else %}
<a {% if class %}class="{{ class }}"{% endif %} href="{{ nav_item.url|url }}">{{ nav_item.parent.title }}</a>
{% endif %}
{%- endmacro -%}
{% macro non_index_item( nav_item, class ) -%}
{% if nav_item.active %}
<span {% if class %}class="{{ class }}"{% endif %}>{{ nav_item.title }}</span>
{% else %}
{% if nav_item.is_section %}
{# nav_item.is_section covers MkDocs Section objects #}
{# MkDocs Section objects do not have a URL to use as a link #}
<span {% if class %}class="{{ class }}"{% endif %}>{{ nav_item.title }}</span>
{% else %}
<a {% if class %}class="{{ class }}"{% endif %} href="{{ nav_item.url|url }}">{{ nav_item.title }}</a>
{% endif %}
{% endif %}
{%- endmacro -%}