Move adventure changelogs to pages section for manual ToC creation

Author: Strokkur424

astro.config.ts

@@ -396,9 +396,12 @@ export default defineConfig({
                 {
                   label: "Version History",
                   items: [
-                    "adventure/version-history/adventure",
-                    "adventure/version-history/adventure-platform",
-                    "adventure/version-history/adventure-platform-fabric",
+                    { label: "adventure", link: "/adventure/version-history/adventure" },
+                    { label: "adventure-platform", link: "/adventure/version-history/adventure-platform" },
+                    {
+                      label: "adventure-platform-fabric",
+                      link: "/adventure/version-history/adventure-platform-fabric",
+                    },
                   ],
                 },
               ],

src/components/adventure/AdventureChangelogs.astro

@@ -1,36 +1,52 @@
 ---
-import { fetchRelease } from "../../utils/releases";
+import { type Release, fetchRelease } from "../../utils/releases";
 import { render } from "../../utils/markdown";
 
+import StarlightPage from "@astrojs/starlight/components/StarlightPage.astro";
+import type { MarkdownHeading } from "astro";
+
 interface Props {
+  title: string;
   repo: string;
 }
 
 const props: Props = Astro.props;
-const data = await fetchRelease(props.repo);
+const data: Release[] = await fetchRelease(props.repo);
+
+const headings: MarkdownHeading[] = data.map((e) => {
+  return {
+    depth: 2,
+    slug: `release-${e.tag}`,
+    text: `${e.tag_name} ${e.name}`,
+  };
+});
 ---
 
-{
-  data.map(async (release) => (
-    <div>
-      <a class="title" href={`#release-${release.tag}`}>
-        <h2 id={`release-${release.tag}`}>{release.name}</h2>
-      </a>
-      <p class="released">
-        Released on{" "}
-        <time datetime={release.published}>
-          {new Date(release.published).toLocaleDateString("en", {
-            dateStyle: "medium",
-            timeZone: "UTC",
-          })}
-        </time>{" "}
-        - <a href={release.url}>GitHub</a>
-      </p>
-      <p set:html={await render(release.body)} />
-      <br />
-    </div>
-  ))
-}
+<StarlightPage headings={headings} frontmatter={{ title: props.title }}>
+  {
+    data.map(async (release) => (
+      <div>
+        <a class="title" href={`#release-${release.tag}`}>
+          <h2 id={`release-${release.tag}`}>
+            {release.tag_name} {release.name}
+          </h2>
+        </a>
+        <p class="released">
+          Released on{" "}
+          <time datetime={release.published}>
+            {new Date(release.published).toLocaleDateString("en", {
+              dateStyle: "medium",
+              timeZone: "UTC",
+            })}
+          </time>{" "}
+          - <a href={release.url}>GitHub</a>
+        </p>
+        <p set:html={await render(release.body)} />
+        <br />
+      </div>
+    ))
+  }
+</StarlightPage>
 
 <style>
   .title {

src/content/docs/adventure/version-history/adventure-platform.mdx

@@ -1,9 +1,5 @@
 ---
-title: adventure-platform-fabric
-description: Changelogs for the Fabric platform implementation!
-tableOfContents: false
----
-
 import AdventureChangelogs from "/src/components/adventure/AdventureChangelogs.astro";
+---
 
-<AdventureChangelogs repo="KyoriPowered/adventure-platform-fabric" />
+<AdventureChangelogs repo="KyoriPowered/adventure-platform-fabric" title="adventure-platform-fabric" />

src/content/docs/adventure/version-history/adventure.mdx

@@ -0,0 +1,5 @@
+---
+import AdventureChangelogs from "/src/components/adventure/AdventureChangelogs.astro";
+---
+
+<AdventureChangelogs repo="KyoriPowered/adventure-platform" title="adventure-platform" />

src/content/docs/adventure/version-history/adventure-platform-fabric.mdx renamed to src/pages/adventure/version-history/adventure-platform-fabric.astro

@@ -0,0 +1,5 @@
+---
+import AdventureChangelogs from "/src/components/adventure/AdventureChangelogs.astro";
+---
+
+<AdventureChangelogs repo="KyoriPowered/adventure" title="adventure" />

src/pages/adventure/version-history/adventure-platform.astro

@@ -1,4 +1,4 @@
-interface Release {
+export interface Release {
   name: string;
   body: string;
   published: string;
@@ -44,7 +44,7 @@ export async function fetchRelease(repo: string): Promise<Release[]> {
         published: obj.published_at ?? "2000-01-01",
         url: obj.html_url ?? "about:blank",
         tag: obj.tag_name?.replaceAll(".", "-") ?? "none",
-        tag_name: obj.tag_name ?? "v1.0.0"
+        tag_name: obj.tag_name ?? "v1.0.0",
       };
     })
     // Post-processing
@@ -80,7 +80,8 @@ function handleRegex(obj: Release, regex: RegExp, onMatch: (match: string) => st
   }
 
   const alreadyMatched: string[] = [];
-  obj.body.matchAll(regex)
+  obj.body
+    .matchAll(regex)
     .map((match) => match[0])
     .forEach((match) => {
       if (alreadyMatched.find((e) => e == match) != null) {