From 90fea1f2f62e68273f143f0ac539b6d376b0bb85 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Moritz=20H=C3=B6lting?=
 <87192362+moritz-hoelting@users.noreply.github.com>
Date: Wed, 18 Mar 2026 14:31:42 +0100
Subject: [PATCH] redesign: add toc to ArticleContent

---
 src/components/ArticleContent.astro | 96 +++++++++++++++++++++++++++--
 src/components/Container.astro      |  4 +-
 2 files changed, 93 insertions(+), 7 deletions(-)

diff --git a/src/components/ArticleContent.astro b/src/components/ArticleContent.astro
index 2afc9fa..4c7474b 100644
--- a/src/components/ArticleContent.astro
+++ b/src/components/ArticleContent.astro
@@ -8,18 +8,72 @@ type Props = {
 
 const { entry } = Astro.props;
 
-const { Content } = await render(entry);
+const { Content, headings } = await render(entry);
 ---
 
-<Container size="md">
-    <article class="animate content">
-        <Content />
-    </article>
-</Container>
+<div class="article-layout">
+    <!-- Sidebar -->
+    <aside
+        class="animate toc font-departure max-w-3xl mx-auto px-5 xl:fixed xl:top-24 xl:right-[max(2rem,calc((100vw-84rem)/2))] xl:h-max xl:w-66"
+    >
+        <h3 class="font-semibold text-[0.9rem] opacity-70 mb-2">
+            On this page
+        </h3>
+        <ul class="list-none p-0 m-0">
+            {
+                headings.map((h) => (
+                    <li class={`level-${h.depth}`}>
+                        <a href={`#${h.slug}`}>{h.text}</a>
+                    </li>
+                ))
+            }
+        </ul>
+    </aside>
+
+    <!-- Main content -->
+    <Container size="md">
+        <article class="animate content">
+            <Content />
+        </article>
+    </Container>
+</div>
+
+<style>
+    .toc li {
+        margin-bottom: 0.4rem;
+    }
+
+    .toc li.level-2 {
+        margin-left: 0.5rem;
+    }
+    .toc li.level-3 {
+        margin-left: 1rem;
+    }
+
+    .toc a {
+        opacity: 0.7;
+        text-decoration: none;
+        transition: opacity 0.15s ease;
+    }
+
+    .toc a.active {
+        opacity: 1;
+        font-weight: 600;
+    }
+
+    .toc a:hover {
+        opacity: 1;
+    }
+
+    article.content {
+        grid-area: content;
+    }
+</style>
 
 <style is:global>
     article.content :is(h1, h2, h3, h4, h5, h6) {
         font-family: "DepartureMono", monospace;
+        scroll-margin-top: 6rem;
     }
 
     article.content a {
@@ -31,3 +85,33 @@ const { Content } = await render(entry);
         text-decoration: underline;
     }
 </style>
+
+<script>
+    const headings = document.querySelectorAll(
+        "article.content h1[id], article.content h2[id], article.content h3[id]",
+    );
+    const tocLinks = document.querySelectorAll(".toc a");
+
+    const observer = new IntersectionObserver(
+        (entries) => {
+            entries.forEach((entry) => {
+                if (entry.isIntersecting) {
+                    const id = entry.target.getAttribute("id");
+
+                    tocLinks.forEach((link) => {
+                        link.classList.toggle(
+                            "active",
+                            link.getAttribute("href") === `#${id}`,
+                        );
+                    });
+                }
+            });
+        },
+        {
+            rootMargin: "0px 0px -80% 0px",
+            threshold: 0.1,
+        },
+    );
+
+    headings.forEach((h) => observer.observe(h));
+</script>
diff --git a/src/components/Container.astro b/src/components/Container.astro
index b44de3f..89195d3 100644
--- a/src/components/Container.astro
+++ b/src/components/Container.astro
@@ -3,9 +3,10 @@ import { cn } from "@/lib/utils";
 
 type Props = {
     size: "sm" | "md" | "lg" | "xl" | "2xl";
+    class?: string;
 };
 
-const { size } = Astro.props;
+const { size, class: className } = Astro.props;
 ---
 
 <div
@@ -16,6 +17,7 @@ const { size } = Astro.props;
         size === "lg" && "max-w-5xl",
         size === "xl" && "max-w-7xl",
         size === "2xl" && "max-w-screen-2xl",
+        className,
     )}
 >
     <slot />