文件库使用说明
这是这个文件库的第一份文件,也是它的规则说明书。
1. 文件放哪里
所有 HTML 放进 output/,用一级子文件夹当分类,目录页会自动按文件夹分组:
output/学习报告/第三周复盘_20261030.htmloutput/实验记录/紫甘蓝指示剂_20261031.html
直接放在 output/ 根目录的文件会进入「未分类」。
2. 怎么出新版本
永远新建文件,不要覆盖旧文件。
文件名末尾带日期:
这样旧版本不会被冲掉,链接也永远指向同一个地址。
文件名末尾带日期:
_20261030、_20261105。这样旧版本不会被冲掉,链接也永远指向同一个地址。
3. 目录页怎么更新
运行一次同步:
node tools/sync-library.js- 用 MD5 比对内容,只处理真正新增或改过的文件;
- 重复运行不会出错,也不会重复写入;
- 没有变化时,目录页一个字节都不会动。
4. 三种标记
| 标记 | 含义 |
|---|---|
| NEW | 近 3 天内新增或修改过的文件 |
| 日期 | 文件的最后修改日期 |
| 大小 | 文件体积,用来判断是单页还是带图的报告 |
5. 每天自动检查
每天固定时间自动扫一次:有新增才同步并重新发布,没有就不动。你不需要收到任何通知。