feature: source section title from index.md for breadcrumbs

Signed-off-by: squidfunk <martin.donath@squidfunk.com>

Author: squidfunk

dist/partials/path-item.html

@@ -1,28 +1,38 @@
 {#-
   This file was automatically generated - do not edit
 -#}
-{% macro render_content(nav_item) %}
+{% macro render_content(nav_item, ref) %}
+  {% set ref = ref or nav_item %}
   <span class="md-ellipsis">
-    {{ nav_item.title }}
+    {{ ref.title or nav_item.title }}
   </span>
 {% endmacro %}
 {% macro render(nav_item, ref) %}
   {% set ref = ref or nav_item %}
   {% if nav_item.children %}
-    {% set first = nav_item.children | first %}
+    {% set _ = namespace(index = none) %}
+    {% if "navigation.indexes" in features %}
+      {% for item in nav_item.children %}
+        {% if item.is_index and _.index is none %}
+          {% set _.index = item %}
+        {% endif %}
+      {% endfor %}
+    {% endif %}
+    {% set index = _.index %}
+    {% set first = index or nav_item.children | first %}
     {% if first.children %}
       {{ render(first, ref) }}
     {% else %}
       <li class="md-path__item">
         <a href="{{ first.url | url }}" class="md-path__link">
-          {{ render_content(ref) }}
+          {{ render_content(first, ref) }}
         </a>
       </li>
     {% endif %}
   {% else %}
     <li class="md-path__item">
       <a href="{{ nav_item.url | url }}" class="md-path__link">
-        {{ render_content(ref) }}
+        {{ render_content(first, ref) }}
       </a>
     </li>
   {% endif %}

src/partials/path-item.html

@@ -24,9 +24,10 @@
 -->
 
 <!-- Render navigation link content -->
-{% macro render_content(nav_item) %}
+{% macro render_content(nav_item, ref) %}
+  {% set ref = ref or nav_item %}
   <span class="md-ellipsis">
-    {{ nav_item.title }}
+    {{ ref.title or nav_item.title }}
   </span>
 {% endmacro %}
 
@@ -36,7 +37,20 @@
 
   <!-- Navigation item with nested items -->
   {% if nav_item.children %}
-    {% set first = nav_item.children | first %}
+
+    <!-- Determine all nested items that are index pages -->
+    {% set _ = namespace(index = none) %}
+    {% if "navigation.indexes" in features %}
+      {% for item in nav_item.children %}
+        {% if item.is_index and _.index is none %}
+          {% set _.index = item %}
+        {% endif %}
+      {% endfor %}
+    {% endif %}
+    {% set index = _.index %}
+
+    <!-- Use index page as entry point if present, otherwise first child -->
+    {% set first = index or nav_item.children | first %}
 
     <!-- Recurse, if the first item has further nested items -->
     {% if first.children %}
@@ -46,7 +60,7 @@
     {% else %}
       <li class="md-path__item">
         <a href="{{ first.url | url }}" class="md-path__link">
-          {{ render_content(ref) }}
+          {{ render_content(first, ref) }}
         </a>
       </li>
     {% endif %}
@@ -55,7 +69,7 @@
   {% else %}
     <li class="md-path__item">
       <a href="{{ nav_item.url | url }}" class="md-path__link">
-        {{ render_content(ref) }}
+        {{ render_content(first, ref) }}
       </a>
     </li>
   {% endif %}