Fix an issue where search bar didn't show on online docs. This is fixed...

Fix an issue where search bar didn't show on online docs. This is fixed permanently by only installing the current version of mkdocs-material, so future updates do not break out code.

Fix an issue where styles.css was not accessible to the website, by changing from combinatronics to jsdelivr as service for accessing the raw css file hosted on github.

.github/workflows/deploy_website.yml

@@ -11,7 +11,7 @@ jobs:
       - uses: actions/setup-python@v2
         with:
           python-version: 3.x
-      - run: pip install mkdocs-material
+      - run: pip install mkdocs-material==9.0.3
       - run: pip install https://github.com/mitya57/python-markdown-math/archive/master.zip
       - run: pip install mkdocs-exclude
       - run: pip install mkdocs-redirects

mkdocs.yml

@@ -15,7 +15,7 @@ theme:
 docs_dir: 'doc'
 extra_css:
     - custom.css
-    - https://combinatronics.com/maths/moodle-qtype_stack/master/styles.css
+    - 'https://cdn.jsdelivr.net/gh/maths/moodle-qtype_stack@master/styles.css'
 markdown_extensions:
     - mdx_math
     - extra

site_overrides/main.html

@@ -26,11 +26,11 @@
     </label>
     <!--Make site title permament -->
     <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis md-header__topic md-ellipsis">
-        {{ config.site_name }}
+      <div class="md-header__ellipsis md-ellipsis">
+        <b>{{ config.site_name }}</b>
       </div>
     </div>
-     {% if "search" in config["plugins"] %}
+     {% if "material/search" in config.plugins %}
       <label class="md-header__button md-icon" for="__search">
         {% include ".icons/material/magnify.svg" %}
       </label>

site_overrides/partials/nav-item.html

@@ -3,7 +3,6 @@
   {% if nav_item.active %}
     {% set class = class ~ " md-nav__item--active" %}
   {% endif %}
-
 <!--Skip first level in the navigation bar, i.e. the "En" level-->
   {%if nav_item.title == "En"%}
     {% set base = path %}
@@ -20,17 +19,39 @@
       {% set class = class ~ " md-nav__item--section" %}
     {% endif %}
     <li class="{{ class }} md-nav__item--nested">
+      {% set expanded = "navigation.expand" in features %}
+      {% set active = nav_item.active or expanded %}
       {% set checked = "checked" if nav_item.active %}
-      {% if "navigation.expand" in features and not checked %}
-        <input class="md-nav__toggle md-toggle" data-md-toggle="{{ path }}"
-        data-md-state="indeterminate" type="checkbox" id="{{ path }}" checked>
-      {% else %}
-        <input class="md-nav__toggle md-toggle" data-md-toggle="{{ path }}" type="checkbox" id="{{ path }}" {{ checked }}>
+      {% if expanded and not checked %}
+        {% set indeterminate = "md-toggle--indeterminate" %}
+      {% endif %}
+      <input class="md-nav__toggle md-toggle {{ indeterminate }}" data-md-toggle="{{ path }}" 
+      type="checkbox" id="{{ path }}" {{ checked }}>
+      {% set indexes = [] %}
+      {% if "navigation.indexes" in features %}
+        {% for nav_item in nav_item.children %}
+          {% if nav_item.is_index and not index is defined %}
+            {% set _ = indexes.append(nav_item) %}
           {% endif %}
-      <label class="md-nav__link" for="{{ path }}">
+        {% endfor %}
+      {% endif %}
+      {% if not indexes %}
+        <label class="md-nav__link" for="{{ path }}" tabindex="0" aria-expanded="{{ nav_item.active | tojson }}">
           {{ nav_item.title }}
           <span class="md-nav__icon md-icon"></span>
         </label>
+      {% else %}
+        {% set index = indexes | first %}
+        {% set class = "md-nav__link--active" if index == page %}
+        <div class="md-nav__link md-nav__link--index {{ class }}">
+          <a href="{{ index.url | url }}">{{ nav_item.title }}</a>
+          {% if nav_item.children | length > 1 %}
+            <label for="{{ path }}">
+              <span class="md-nav__icon md-icon"></span>
+            </label>
+          {% endif %}
+        </div>
+      {% endif %}
       <nav class="md-nav" aria-label="{{ nav_item.title }}" data-md-level="{{ level }}">
         <label class="md-nav__title" for="{{ path }}">
           <span class="md-nav__icon md-icon"></span>
@@ -38,7 +59,9 @@
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           {% for nav_item in nav_item.children %}
+            {% if not indexes or nav_item != indexes | first %}
               {{ render(nav_item, path ~ "_" ~ loop.index, level + 1) }}
+            {% endif %}
           {% endfor %}
         </ul>
       </nav>