内容系统与标签策略:让 Blog 和 Notes 各司其职
· 2 分钟阅读
内容系统分成两条线:blog 用来承载完整文章,notes 用来记录短小但有价值的维护片段。两者都进入搜索索引,但语气和结构不同。
Blog 的职责
Blog 应该回答一个完整问题。文章可以包含上下文、取舍、实现细节和维护建议。
这些内容会出现在博客列表、详情页、RSS 和 OG 图片中,所以 frontmatter 的 description 与 tags 要写得清楚。
Notes 的职责
Notes 更像项目维护日志。它可以记录一个 bug 的原因、一个约定的边界、一次配置变更,或者一个常用命令背后的注意点。
笔记不需要长篇铺陈,但要给未来的维护者留下足够线索:发生了什么、为什么这样处理、下次遇到时看哪里。
标签覆盖
标签不只是装饰,它会影响归档扫描和搜索召回。这个项目建议覆盖以下几类:
- 技术栈:
astro、react、tailwind、typescript - 架构边界:
architecture、islands、browser-init - 内容维护:
content、markdown、tags、search - 视觉与生成:
design-system、og-image、svg、automation - 质量保障:
testing、typecheck、workflow
当一篇内容横跨多个领域时,优先选择最能帮助检索的标签,而不是把所有相关词都塞进去。