{#
/overrides/main.html
Fixed MkDocs Material template override that preserves the standard layout
while enabling the comments panel through the existing toc.html partial.
CRITICAL: Do NOT override {% block content %} as it breaks Material Design
CSS selectors and causes layout issues (giant icons, broken navigation, etc.).
The comments panel functionality is implemented via overrides/partials/toc.html
which properly integrates with Material's sidebar structure.
#}
{% extends "base.html" %}
{#
Template extends base.html without overriding critical blocks.
Comments functionality is handled by overrides/partials/toc.html
which preserves Material Design CSS compatibility.
#}
{% block extrahead %}
{# Ensure index pages get the `is-index` class early so CSS rules apply
even if page_classer.js runs late or JS is blocked. This small inline
script runs during head parsing and avoids FOUC where the index would
initially be rendered with a sidebar overlay hiding content on some
browsers (notably Edge mobile/desktop variations). #}
<script>try{if(typeofDOCUMENTATION_OPTIONS!=='undefined'&&DOCUMENTATION_OPTIONS.pagename==='index'){document.documentElement.classList.add('is-index');if(document.body)document.body.classList.add('is-index');}}catch(e){/* swallow errors */}</script>
{{ super() }}
{% endblock %}
{# /overrides/main.html Fixed MkDocs Material template override that preserves the standard layout while enabling the comments panel through the existing toc.html partial. CRITICAL: Do NOT override {% block content %} as it breaks Material Design CSS selectors and causes layout issues (giant icons, broken navigation, etc.). The comments panel functionality is implemented via overrides/partials/toc.html which properly integrates with Material's sidebar structure. #} {% extends "base.html" %} {# Template extends base.html without overriding critical blocks. Comments functionality is handled by overrides/partials/toc.html which preserves Material Design CSS compatibility. #} {% block extrahead %} {# Ensure index pages get the `is-index` class early so CSS rules apply even if page_classer.js runs late or JS is blocked. This small inline script runs during head parsing and avoids FOUC where the index would initially be rendered with a sidebar overlay hiding content on some browsers (notably Edge mobile/desktop variations). #} <script> try { if (typeof DOCUMENTATION_OPTIONS !== 'undefined' && DOCUMENTATION_OPTIONS.pagename === 'index') { document.documentElement.classList.add('is-index'); if (document.body) document.body.classList.add('is-index'); } } catch (e) { /* swallow errors */ } </script> {{ super() }} {% endblock %}