站点更新
笔记按主题分成几组,左侧目录由目录结构自动生成 —— 往对应目录放 .md 文件即可出现,不用改配置。
| 分组 | 目录 | 放什么 |
|---|---|---|
| 本站 | docs/notes/site/ | 建站、部署、站点维护 |
| Math | docs/notes/math/ | 数学基础与推导 |
| 经典 | docs/notes/classic/ | 论文、教材、工程经典 |
本站
- 从零搭这个站 — 项目结构、常用命令、新增文章的约定
- 部署到 Cloudflare Pages — 构建参数、绑域名、常见报错
约定
三件事
- 正文写一个
# 标题(放在 frontmatter 下面即可),侧边栏条目名直接取它,不用另外配置。 - 想固定顺序,在 frontmatter 里加
order: 1(数字小的在前);不写则按文件名排序,index.md永远排第一。 - 分组里有
index.md就会出现「概览」条目;不需要概览就删掉它,组名改由组内任一文章声明group: 本站+group_order: 1。
运行时增删文件后要重启 docs:dev 才会生效 —— 侧边栏在启动时扫描一次,之后不会自动重扫。
