向叔记事簿 返回博客

章节 · 1/3

先把内容当成一棵树

目录负责归属,weight 负责顺序;日期不再决定读者从哪里开始。

最后更新

博客的默认单位是一篇文章:写完、发布、归档,读者通常从最新一篇往回看。课程不是这样。课程的第一章即使一年没更新,也依然应该排在读者面前;中间插入一节补充内容,也不该打乱原有的阅读路径。

因此,学习区先用目录声明“这是谁的一部分”,再用 weight 声明“它应该排在第几位”。例如:

content/learning/hugo-learning-path/
├── _index.md
├── 01-content-tree/
│   └── index.md
└── 02-reading-template/
    └── index.md

顶层 hugo-learning-path 是一个集合,它的 _index.md 说明这门课解决什么问题。每个章节目录中的 index.md 是可独立阅读的页面;如果一部分内容下面还会继续长出小节,就把该层写成 _index.md,让它既能写导言,也能容纳子章节。

weight 不需要连续。先写 102030,以后要在前两章之间补一节时,用 15 即可。这样,文件夹名字帮助人理解结构,weight 则成为模板可稳定读取的阅读顺序。

日期仍有价值,但它只回答“这页最后更新是什么时候”,不再替读者决定“我下一步该读什么”。这是学习内容和日常博客最重要的分界线。

本页内容