navigation

Author: janpio

theme/toc.html

@@ -1,25 +1,64 @@
-{% if nav_item.children %}
-  {% if not nav_item.title.startswith("_") %}
+{# loop through all navigation items #}
+
+{# if the current item title does not start with _ #}
+{% if not nav_item.title.startswith("_") %}
+  {# if the current item has children #}
+  {% if nav_item.children %}
     <ul class="subnav">
       <li><span>{{ nav_item.title }}</span></li>
+      {# output children #}
       {% for nav_item in nav_item.children %}
-      {% include 'toc.html' %}
+        {% include 'toc.html' %}
       {% endfor %}
     </ul>
-  {% endif %}
-{% else %}
-  {% if not nav_item.title.startswith("_") %}
-    <li class="toctree-l1 {% if nav_item.active%}current{%endif%}">
-      <a class="{% if nav_item.active%}current{%endif%}" href="{{ nav_item.url }}">{{ nav_item.title }}</a>
+  {# if the current item does not have children #}
+  {% else %}
+    <li class="toctree-l1 
+    {# if current item is active #}
+    {% if nav_item.active %}current{% endif %}
+    {# if current page has ancestors and current item title prefixed with _ is identical to ancestor title (_ + Action <=> _Action) #}
+    {% if current_page and current_page.ancestors %}{% for doc in current_page.ancestors %}{% if "_"+nav_item.title == doc.title and nav_item.title != "Tools" %}current{% endif %}{% endfor %}{% endif %}
+    ">
+      <a class="
+      {% if nav_item.active %}current{% endif %}
+      {% if current_page and current_page.ancestors %}{% for doc in current_page.ancestors %}{% if "_"+nav_item.title == doc.title and nav_item.title != "Tools" %}current{% endif %}{% endfor %}{% endif %}
+      " href="{{ nav_item.url }}">
+        {{ nav_item.title }}
+      </a>
+      {# if current item is current page #}
       {% if nav_item == current_page %}
-      <ul>
-        {% for toc_item in toc %}
-          {% if loop.index != 1 %}
-          <li class="toctree-l3"><a href="{{ toc_item.url }}">{{ toc_item.title }}</a></li>
-          {% endif %}
-        {% endfor %}
-      </ul>
+        <ul>
+          {# output headlines #}
+          {% for toc_item in toc %}
+            {% if loop.index != 1 %}
+              <li class="toctree-l3"><a href="{{ toc_item.url }}">{{ toc_item.title }}</a></li>
+            {% endif %}
+          {% endfor %}
+        </ul>
       {% endif %}
     </li>
   {% endif %}
 {% endif %}
+
+{# if current page title is _Tools #}
+{% if nav_item.title == "_Tools" %}
+  {% if current_page and current_page.title == "Tools" %}
+    <ul class="subnav">
+      {% for nav_item in nav_item.children %}
+        {% include 'toc.html' %}
+      {% endfor %}
+    </ul>
+  {% else %}
+    {% if current_page and current_page.ancestors %}
+      {% for doc in current_page.ancestors %}
+        {% if nav_item.title == doc.title %}
+          <ul class="subnav">
+            {% for nav_item in nav_item.children %}
+              {% include 'toc.html' %}
+            {% endfor %}
+          </ul>
+        {% endif %}
+      {% endfor %}
+    {% endif %}
+  {% endif %}
+{% endif %}