静态文档站的构建与发布

为什么要静态

这个站点的目标只有一个：把写好的内容长期、稳定地放出来。没有用户系统、没有评论、没有后台编辑。既然没有动态需求，就不该引入数据库和运行时的维护成本——能被删除的组件，比能被修好的组件更可靠。

结构

site/
├── index.html
├── notes/            列表 + 每篇一个 HTML
├── projects/         列表 + 每个项目一个 HTML
├── status.html       状态页（发布时更新）
├── downloads/        下载页
├── files/            可供下载的脚本与文档
└── assets/style.css  全站共用样式

不引入构建工具。新增一篇文章 = 新建一个 HTML + 在列表页加一行链接，改动范围肉眼可见。

发布流程

1. 本地改内容，起一个临时静态服务器预览。
2. 检查链接、标题、页脚三样东西是否齐全。
3. 推送到服务器目录，替换文件。
4. 用外部请求验收：状态码、页面字节数、关键文字是否出现。

第 4 步不能省。只看「文件已复制」不算发布成功——缓存、权限、路径任何一环都可能让线上仍是旧内容。

页面必须长期保持一致的三样

代价与取舍

静态站的代价是内容多了以后不好整理，所以目录要保持浅、命名要有规律。换来的好处是：任何一台机器、任何一个静态服务器，十分钟就能把整站搬过去——这份可迁移性，比任何花哨的功能都值钱。