🏗️ Template Hierarchy
The four core layouts render content using dedicated wrappers:
_layouts/
├── default.html # Renders <h2 id="-google-translate-module-translatejs">🌐 Google Translate Module (<code class="language-yaml highlighter-rouge"><span class="s">translate.js</span></code>)</h2>
<p>The translation engine operates in a self-executing closure:</p>
<ol>
<li>Reads the <code class="language-yaml highlighter-rouge"><span class="s">googtrans</span></code> cookie or URL query <code class="language-yaml highlighter-rouge"><span class="s">?lang=<code></span></code>.</li>
<li>Suppresses default Google Translate banners and tooltips.</li>
<li>Automatically triggers hidden <code class="language-yaml highlighter-rouge"><span class="s">goog-te-combo</span></code> select elements on change.</li>
<li>Preserves language selection across page reloads and relative navigation.</li>
</ol>
<hr />
<h2 id="️-mermaid-integration-mermaid-initjs">🧜♀️ Mermaid Integration (<code class="language-yaml highlighter-rouge"><span class="s">mermaid-init.js</span></code>)</h2>
<p>The Mermaid module dynamically enhances pages after DOM content loads:</p>
<ol>
<li>Scans the DOM for <code class="language-yaml highlighter-rouge"><span class="s"><pre class="language-mermaid"></span></code> or <code class="language-yaml highlighter-rouge"><span class="s"><div class="language-mermaid"></span></code>.</li>
<li>Extracts raw Mermaid diagram syntax.</li>
<li>Initializes Mermaid with custom dark mode variables (<code class="language-yaml highlighter-rouge"><span class="c1">#07111f</span></code>, <code class="language-yaml highlighter-rouge"><span class="c1">#48d8f2</span></code>).</li>
<li>Replaces code blocks with <code class="language-yaml highlighter-rouge"><span class="s"><pre class="mermaid"></span></code> and executes <code class="language-yaml highlighter-rouge"><span class="s">mermaid.run()</span></code>.</li>
<li>Automatically wraps bare <code class="language-yaml highlighter-rouge"><span class="s"><table></span></code> elements in responsive <code class="language-yaml highlighter-rouge"><span class="s">.table-wrap</span></code> divs.</li>
</ol>
in <article class="doc-section documentation-content">
├── docs.html # Renders breadcrumbs, reading pager, and docs content
├── wiki.html # Renders interactive search filter, topic tree, and wiki content
└── catalogue.html # Extends default.html with .catalogue-layout wrapper
🪝 Include Extension Hooks
The theme provides three placeholder includes allowing users to inject custom elements:
_includes/head_custom.html: Injected right before</head>for external CSS or analytics._includes/header_custom.html: Injected into the top navbar for extra links or brand marks._includes/footer_custom.html: Injected into the footer for copyright or build info.