src/content/<locale>/docs/ 下的嵌套文件夹会直接驱动侧边栏树,并在公开 URL 中保留各级路径。

映射示例

这些源文件会映射成如下路由:

源文件 路由
src/content/en-US/docs/guides/index.md /docs/guides
src/content/en-US/docs/guides/sidebar-nesting.md /docs/guides/sidebar-nesting
src/content/en-US/docs/guides/route-shape.md /docs/guides/route-shape

Catch-all 页面

pages/[locale]/docs/[...slug].server.ts 加载器负责嵌套路径。内容集合提供每个页面预渲染所需的 slug,包括 guides/sidebar-nesting 这样的路径。

实际上的结论

把文档组织在文件夹里,就能获得可折叠的侧边栏导航和对应的 / 分隔路由。index.md 文件映射到所在文件夹的路由。