feat: add automatic Table of Contents for pages\n\n- Render .TableOfContents in single template when available\n- Add basic TOC styling in main.css

Author: ntk148v

assets/css/main.css

@@ -412,6 +412,36 @@ blockquote > :last-child {
   margin-bottom: 0;
 }
 
+/* Table of Contents */
+.toc {
+  margin: var(--spacing-base) 0;
+  padding: var(--spacing-sm);
+  border: 1px solid var(--color-border);
+  background: var(--color-bg-secondary);
+  border-radius: var(--border-radius);
+}
+
+.toc h2 {
+  margin: 0 0 var(--spacing-sm) 0;
+  font-weight: bold;
+  font-size: 0.95em;
+}
+
+.toc .toc-content ul {
+  list-style: none;
+  margin: 0;
+  padding-left: 1em;
+}
+
+.toc .toc-content a {
+  text-decoration: none;
+  color: var(--color-text-primary);
+}
+
+.toc .toc-content a:hover {
+  text-decoration: underline;
+}
+
 @media (max-width: 600px) {
   .path-nav li {
     max-width: 100px; /* More aggressive truncation on mobile */

layouts/_default/single.html

@@ -1,6 +1,17 @@
 {{ define "main" }}
   <h1>{{ .Title }}</h1>
   {{ partial "terms.html" (dict "taxonomy" "tags" "page" .) }}
+
+  {{/* Table of Contents: render only when the page has one */}}
+  {{ if .TableOfContents }}
+    <nav class="toc">
+      <h2>Table of contents</h2>
+      <div class="toc-content">
+        {{ .TableOfContents }}
+      </div>
+    </nav>
+  {{ end }}
+
   {{ .Content }}
   {{ partial "date.html" .Date}}