怎么组织一个教程 / 类目

怎么组织一个教程 / 类目

1. 一个类目 = 一个子文件夹

想让一组文章归到同一个侧边栏分组下？

• 新建文件夹：src/content/docs/我的教程/
• 把所有文章扔进去
• 在 astro.config.mjs 的 sidebar 里加一条：

sidebar: [
  {
    label: '我的教程',                      // 侧边栏分组名
    autogenerate: { directory: '我的教程' }, // 对应文件夹名
  },
]

2. 控制文章顺序

每篇文章 frontmatter 里加 sidebar.order：

---
title: 第一章：开篇
sidebar:
  order: 1
---

---
title: 第二章：进阶
sidebar:
  order: 2
---

数字越小越靠上。不写就按文件名字母序排。

3. 让文章之间互相链接

文章之间用相对路径链接：

• [下一章](/我的教程/第二章/) ← 注意末尾斜杠
• 文件名 第二章.mdx → URL /我的教程/第二章/
• URL 里没有 .md 后缀，文件夹名直接对应路径段

4. URL 命名建议

• 用英文/拼音做文件名（lesson-1.mdx → /lesson-1/），URL 更干净
• 中文文件名也能用，但 URL 会被编码成 %E4%B8%AD... 不美观

5. 单篇 vs 系列教程

需求	做法
写一篇文章	直接放 src/content/docs/xxx.mdx
写一系列教程	新建子文件夹 + sidebar 加分组
想精确控制顺序	sidebar 用 items 手动列每条

具体例子见 guide/ 文件夹下的两篇文章。