Docs version selector

docs/astro.config.mjs

@@ -5,13 +5,19 @@ import rehypeMathjax from 'rehype-mathjax';
 
 // https://astro.build/config
 export default defineConfig({
+  base: '/v0.3',
+  outDir: './dist/v0.3',
   markdown: {
     remarkPlugins: [remarkMath],
     rehypePlugins: [rehypeMathjax],
   },
 	integrations: [
 		starlight({
 			title: 'Continuous Eval',
+      components: {
+        // Override the default `SocialIcons` component.
+        ThemeSelect: './src/components/ThemeSelect.astro',
+      },
 			tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 4, },
 			customCss: [
 				// Relative path to your custom CSS file

docs/src/components/ThemeSelect.astro

@@ -0,0 +1,29 @@
+---
+import type { Props } from '@astrojs/starlight/props';
+import Default from '@astrojs/starlight/components/ThemeSelect.astro';
+import Select from '@astrojs/starlight/components/Select.astro';
+import { defaultVersion, versions } from '../content/config.ts';
+
+const url = new URL(Astro.url);
+const currentVersion = /^\/v\d+/.test(url.pathname)
+  ? url.pathname.split('/')[1]
+  : defaultVersion;
+const options = versions.map(([version, label]) => ({
+  label,
+  selected: currentVersion === version,
+  value: `/${version}`,
+}));
+---
+
+<script>
+  const select = document.querySelector('select');
+  select?.addEventListener('change', () => {
+    const url = new URL(window.location.href);
+    const pathname = select.value + url.pathname.replace(/^\/v\d/, '');
+    url.pathname = pathname.replace(/\/$/, '');
+    window.location.href = url.href;
+  });
+</script>
+
+<Select label="version" value="auto" options={options} width="auto" />
+<Default {...Astro.props}><slot /></Default>

docs/src/content/config.ts

@@ -5,3 +5,12 @@ export const collections = {
 	docs: defineCollection({ schema: docsSchema() }),
 	i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
 };
+
+export const base = '/';
+
+export const versions = [
+  ['v0.3', 'v0.3 (canary)'],
+  ['v0.2', 'v0.2 (latest)'],
+];
+
+export const defaultVersion = 'v0.3';