guide page versioning

Author: outfoxxed

src/components/navigation/sidebars/nav/RootNav.astro

@@ -6,18 +6,18 @@ export interface Props {
 }
 
 import { getVersionsData } from "@config/io/generateTypeData";
+import { getGuideCollection } from "@config/io/guides";
 import type { TreeEntry } from "./Tree.astro";
 import Tree from "./Tree.astro";
 import Link from "./Link.astro";
-import { getCollection } from "astro:content";
 
 const versions = await getVersionsData();
 const versionName = Astro.params.version;
 const modules = versions.versions.find(version => version.name === versionName)?.modules;
 
 const currentPath = Astro.url.pathname.split('/').filter(s => s !== "");
 
-const guidePages = await getCollection("guide");
+const guidePages = await getGuideCollection(versionName ?? "");
 
 interface NavTree {
   title: string,

src/config/io/guides.ts

@@ -0,0 +1,35 @@
+import { type CollectionEntry, getCollection } from "astro:content";
+import { getVersionsData } from "@config/io/generateTypeData";
+
+// load latest version of each page for version
+async function buildGuideCollection(version: string): Promise<CollectionEntry<'guide'>[]> {
+  const { versions } = await getVersionsData();
+  const guidePages = await getCollection("guide");
+
+  const pages: { [key: string]: CollectionEntry<'guide'> } = {};
+
+  for (const currentVersion of versions.toReversed()) {
+    for (const page of guidePages) {
+      let [guideVersion, id] = page.id.split('/');
+      guideVersion = guideVersion.replaceAll('_', '.');
+      id = id ?? "index";
+      if (guideVersion !== currentVersion.name) continue;
+
+      pages[id] = { ...page, id };
+    }
+
+    if (currentVersion.name === version) break;
+  }
+
+  return Object.values(pages);
+}
+
+let guideCollections: { [key: string]: Promise<CollectionEntry<'guide'>[]> } = {};
+
+export async function getGuideCollection(version: string): Promise<CollectionEntry<'guide'>[]> {
+  if (!(version in guideCollections)) {
+    guideCollections[version] = buildGuideCollection(version);
+  }
+
+  return guideCollections[version];
+}

src/content.config.ts

@@ -2,7 +2,7 @@ import { defineCollection, z } from "astro:content";
 import { glob } from "astro/loaders";
 
 const guide = defineCollection({
-	loader: glob({ pattern: "**/*", base: "src/guide" }),
+	loader: glob({ pattern: "**/*.md", base: "src/guide" }),
 	schema: z.object({
 		title: z.string(),
     index: z.number(),

src/guide/distribution.mdx renamed to src/guide/v0_1_0/distribution.mdx

@@ -0,0 +1,4 @@
+---
+title: "Lists and Models"
+index: 2
+---