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 文件映射到所在文件夹的路由。