479 字
2 分钟
这个博客的笔记结构
这个博客会以笔记为主,所以先把笔记的结构定下来。
第一版不打算做得太复杂。Fuwari 本身已经有文章、归档、标签、分类、搜索和 RSS。与其重新做一套知识库系统,不如先复用它的文章模型,再用一点约定把内容组织清楚。
分类只回答一件事
category 只用来说明这篇内容属于哪种大类:
- 笔记
- 项目
- 博客
- 实验
- 随笔
这样分类不会越来越碎。比如一篇 Cloudflare Workers 部署记录,它的分类是“笔记”,而不是“Cloudflare”。
标签负责具体主题
tags 用来描述具体内容和用途:
CloudflareWorkers部署排错FrappeDocker速查
以后想按技术栈、问题类型或者使用场景找内容,都可以靠标签。
笔记类型
当前先按这些类型整理:
- 速查:命令、参数、步骤和常用片段
- 排错:报错原因、排查路径和最后的修复方法
- 配置:环境、工具链、部署和服务配置
- 学习:读文档、看源码、学框架时留下的理解
- 项目笔记:项目推进过程里的设计、接口、测试和取舍
- 阅读摘记:文章、文档、书和资料里值得回看的内容
- 实验记录:动画、音乐、视频和交互效果的试验过程
这些类型目前先作为标签使用。等内容多起来之后,再决定要不要单独做成更强的字段。
写作原则
笔记不追求一次写成完美文章。
对这个博客来说,更重要的是先把有用的信息放下来:当时的问题是什么,怎么查的,最后怎么解决,以及下次遇到时应该从哪里开始。
如果一篇短笔记后来变得很重要,再把它扩展成完整文章也不迟。