博客和项目页分工不同,不要混在一起。
博客是什么,项目页是什么
- 项目页是长期、稳定的教程和指南:一个项目一个页面,结构固定,内容会随项目进展更新,读者是来“学会一件事”的。
- 博客是一篇讲一件事的短文:有日期、有结论、有过程,读者是来“看一个想法、一个坑、一次复盘”的。博客不会因为项目更新就重写,旧文章留着当时的思考记录,新想法写新文章。
博客的分类
以后写博客,按这四类分,不用每次重新想分类:
- 方法笔记:一个方法怎么用、为什么这样用,例如先定模板再填内容、选赛道的六个维度。
- 踩坑复盘:真实踩过的坑、当时怎么想错的、以后怎么自查。
- 进展记录:项目做到哪、还剩什么、下一步,不写成流水账,只写关键节点和决定。
- 思考:对一个问题的判断,例如统一架构和个性化怎么平衡、效率和安全怎么取舍。
博客的固定模板
每篇博客固定四段,标题就是结论或问题:
- 先说结论:这篇要讲什么,一句话说清。
- 怎么做或怎么回事:过程、方法、数据、例子,只写能公开的部分。
- 常见坑:容易错的地方、容易误解的地方。
- 下一步:读完可以做什么、这个项目下一步是什么。
写的时候只讲能公开的部分,节点连接信息、账号密码、私人对话、他人未公开内容一律不写。写新文章的方法:在 content/posts/ 里加一个 Markdown 文件,写好标题和日期,重新生成即可。