fix docs base url

Author: adrum

starlight/astro.config.mjs

@@ -7,6 +7,7 @@ import mdx from "@astrojs/mdx";
 import { injectMdxImports } from "./src/remark/inject-mdx-imports.mjs";
 import { rewriteCodeGroup } from "./src/remark/rewrite-code-group.mjs";
 import { rewriteAsides } from "./src/remark/rewrite-asides.mjs";
+import { prependBaseToLinks } from "./src/remark/prepend-base-to-links.mjs";
 import { sidebarV1 } from "./src/sidebars/v1.mjs";
 import { sidebarV2 } from "./src/sidebars/v2.mjs";
 import { sidebarV3 } from "./src/sidebars/v3.mjs";
@@ -64,11 +65,17 @@ function snippetLoaderPlugin() {
 
 export default defineConfig({
   site: "https://inertiajs.com",
+  base: "/docs",
+  // Emit build output under dist/docs/ so the on-disk layout mirrors
+  // the URL layout. The docs worker is mounted at /docs/* via service
+  // binding — a request for /docs/v3/... resolves to dist/docs/v3/...
+  // without the worker having to rewrite paths.
+  outDir: "./dist/docs",
   // The root splash page lives in a separate repo; this build only owns
   // /docs/*. Redirect the bare /docs entry point to the latest version's
   // intro page so wandering links land somewhere useful.
   redirects: {
-    "/docs": "/docs/v3/getting-started/",
+    "/": "/docs/v3/getting-started/",
   },
   markdown: {
     remarkPlugins: [
@@ -77,6 +84,7 @@ export default defineConfig({
       // need to provide bindings for the originals.
       rewriteCodeGroup,
       rewriteAsides,
+      prependBaseToLinks,
       [
         injectMdxImports,
         {
@@ -104,7 +112,7 @@ export default defineConfig({
         // runs once per navigation.
         {
           tag: "script",
-          attrs: { type: "module", src: "/framework-switcher.js" },
+          attrs: { type: "module", src: "/docs/framework-switcher.js" },
         },
       ],
       expressiveCode: {

starlight/package.json

@@ -8,7 +8,7 @@
     "start": "astro dev",
     "build": "astro build",
     "preview": "astro preview",
-    "deploy": "  npx wrangler deploy",
+    "deploy": "npx wrangler deploy",
     "astro": "astro"
   },
   "dependencies": {

starlight/src/components/SiteTitleWithVersion.astro

@@ -8,7 +8,7 @@ import { getCollection } from "astro:content";
 const allEntries = await getCollection("docs");
 const slugsByVersion: Record<string, Set<string>> = {};
 for (const entry of allEntries) {
-  const m = entry.id.match(/^docs\/(v\d+)\/(.+)$/);
+  const m = entry.id.match(/^(v\d+)\/(.+)$/);
   if (!m) continue;
   const [, version, rest] = m;
   (slugsByVersion[version] ??= new Set()).add(rest);

starlight/src/content/docs/docs/v1

@@ -0,0 +1 @@
+../../../../v1

starlight/src/content/docs/docs/v2

@@ -0,0 +1 @@
+../../../../v2

starlight/src/content/docs/docs/v3

@@ -0,0 +1 @@
+../../../../v3

starlight/src/content/docs/v1

@@ -23,12 +23,9 @@ function cleanMarkdown(content: string): string {
 export const getStaticPaths: GetStaticPaths = async () => {
   const entries = await getCollection("docs");
   return entries
-    .filter((entry) => /^docs\/v\d+\//.test(entry.id))
+    .filter((entry) => /^v\d+\//.test(entry.id))
     .map((entry) => ({
-      // Strip the leading `docs/` from the collection id — the file
-      // sits inside `src/pages/docs/`, so the slug param is the
-      // remainder of the URL between `/docs/` and `.md`.
-      params: { slug: entry.id.replace(/^docs\//, "") },
+      params: { slug: entry.id },
       props: { entry },
     }));
 };