fix: add redirect to raw files as well

Author: atinux

app/layouts/docs.vue

@@ -6,7 +6,6 @@ let observer: IntersectionObserver | undefined
 onMounted(() => {
   // make sure Nuxt finished hydration before observing the navigation
   onNuxtReady(() => {
-    console.log('on nuxt ready')
     observer = observeNavigation(navigationRef)
     watch(sidebar, () => {
       nextTick(() => {

app/utils/navigation.ts

@@ -9,7 +9,6 @@ function prefetchPath(path?: string) {
   }
   nuxtApp = nuxtApp ?? useNuxtApp()
   prefetchedPaths.add(path)
-  console.log('prefetch', path)
   nuxtApp.hooks.callHook('link:prefetch', path)
 }
 
@@ -57,33 +56,8 @@ function walk(items: NavigationItem[], path: string): boolean {
   return false
 }
 
-/**
- * First leaf page under the navigation node at `path`, if `path` is a section (directory) node.
- * Returns `undefined` when the path isn't in the tree or already is a leaf — used to redirect
- * directory URLs like `/getting-started` to their first page.
- */
-export function findFirstLeaf(
-  navigation: NavigationItem[] | undefined | null,
-  path: string | undefined
-): string | undefined {
-  if (!navigation?.length || !path) return undefined
-  const visit = (items: NavigationItem[]): string | undefined => {
-    for (const item of items) {
-      if (item.path === path) {
-        let current = item
-        while (current.children?.length) current = current.children[0]!
-        // Guard: a directory `index.md` is emitted as its own first child — no redirect to self.
-        return current.path !== path ? current.path : undefined
-      }
-      if (item.children?.length) {
-        const found = visit(item.children)
-        if (found) return found
-      }
-    }
-    return undefined
-  }
-  return visit(navigation)
-}
+// Shared with the server-side `/raw/**` mirror (server/routes/raw/[...slug].md.get.ts).
+export { findFirstLeaf } from '../../utils/first-leaf'
 
 export interface BreadcrumbItem {
   title: string

server/routes/raw/[...slug].md.get.ts

@@ -1,3 +1,5 @@
+import { findFirstLeaf } from '../../../utils/first-leaf'
+
 export default defineEventHandler(async (event) => {
   const slug = getRouterParams(event)['slug.md']
   if (!slug?.endsWith('.md')) {
@@ -9,6 +11,12 @@ export default defineEventHandler(async (event) => {
   const path = pagePathFromRawSlug(slug)
   const markdown = await renderPageMarkdown(content, path)
   if (!markdown) {
+    // A directory without an index page (e.g. /raw/getting-started.md) redirects to the
+    // mirror of its first navigation page — same behaviour as the HTML pages.
+    const firstLeaf = findFirstLeaf(await content.navigation(), path)
+    if (firstLeaf) {
+      return sendRedirect(event, `/raw${firstLeaf}.md`, 302)
+    }
     return notFoundMarkdown(event, path)
   }
 

utils/first-leaf.ts

@@ -0,0 +1,29 @@
+import type { NavigationItem } from 'comark-content'
+
+/**
+ * First leaf page under the navigation node at `path`, if `path` is a section (directory) node.
+ * Returns `undefined` when the path isn't in the tree or already is a leaf — used to redirect
+ * directory URLs like `/getting-started` (and their `/raw/**.md` mirrors) to their first page.
+ */
+export function findFirstLeaf(
+  navigation: NavigationItem[] | undefined | null,
+  path: string | undefined
+): string | undefined {
+  if (!navigation?.length || !path) return undefined
+  const visit = (items: NavigationItem[]): string | undefined => {
+    for (const item of items) {
+      if (item.path === path) {
+        let current = item
+        while (current.children?.length) current = current.children[0]!
+        // Guard: a directory `index.md` is emitted as its own first child — no redirect to self.
+        return current.path !== path ? current.path : undefined
+      }
+      if (item.children?.length) {
+        const found = visit(item.children)
+        if (found) return found
+      }
+    }
+    return undefined
+  }
+  return visit(navigation)
+}