Implement mcdoc v0.1.0: public documentation server

Single-binary Go server that fetches markdown from Gitea (mc org), renders to HTML with goldmark (GFM, chroma syntax highlighting, heading anchors), and serves a navigable read-only documentation site. Features: - Boot fetch with retry, webhook refresh, 15-minute poll fallback - In-memory cache with atomic per-repo swap - chi router with htmx partial responses for SPA-like navigation - HMAC-SHA256 webhook validation - Responsive CSS, TOC generation, priority doc ordering - $PORT env var support for MCP agent port assignment 33 tests across config, cache, render, and server packages. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 13:04:15 -07:00
parent 0578dbcb02
commit 28afaa2c56
31 changed files with 2870 additions and 1 deletions
--- a/web/templates/layout.html
+++ b/web/templates/layout.html
@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{{if .Title}}{{.Title}} — {{end}}Metacircular Docs</title>
+    <link rel="stylesheet" href="/static/style.css">
+    <script src="/static/htmx.min.js"></script>
+</head>
+<body>
+    <header>
+        <nav class="breadcrumb">
+            <a href="/" hx-get="/" hx-target="#content" hx-push-url="true">Metacircular Docs</a>
+            {{range .Breadcrumbs}}
+                <span class="sep">/</span>
+                <a href="{{.URL}}" hx-get="{{.URL}}" hx-target="#content" hx-push-url="true">{{.Label}}</a>
+            {{end}}
+        </nav>
+    </header>
+    <main>
+        {{if .Sidebar}}
+        <aside class="sidebar">
+            <nav>
+                <ul>
+                {{range .Sidebar}}
+                    <li{{if .Active}} class="active"{{end}}>
+                        <a href="{{.URL}}" hx-get="{{.URL}}" hx-target="#content" hx-push-url="true">{{.Label}}</a>
+                    </li>
+                {{end}}
+                </ul>
+            </nav>
+        </aside>
+        {{end}}
+        <div id="content">
+            {{block "content" .}}{{end}}
+        </div>
+    </main>
+    <footer>
+        {{if .LastUpdated}}<time>Last updated: {{.LastUpdated}}</time>{{end}}
+    </footer>
+</body>
+</html>