搭建个人博客内容与技术如何协作：用一份交付清单减少返工
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /80aefca770b5.html
📄
搭建个人博客内容与技术如何协作：用一份交付清单减少返工
搭建个人博客时，内容与技术协作的核心不是谁先谁后，而是把“写什么、放在哪、怎么被找到”拆成可交付物，并在动手写正文前先确认页面结构、字段和检查项。多人协作最容易返工的地方，是内容作者不知道标题层级和链接规则，技术一方不知道文章要承载哪些信息。解决办法是准备一份轻量交付清单，让内容先按结构写，技术再按结构实现。
准备阶段：先定内容模型，再谈页面样式
内容模型指一篇文章包含哪些固定字段，例如标题、摘要、正文、标签、发布时间、作者、封面图。技术一方需要知道这些字段是否必填、是否可重复、是否参与列表展示。内容作者需要知道哪些字段会影响读者第一眼看到的信息。
可以用一个假设例子说明：如果博客计划写教程和随笔两类内容，那么“难度”字段只对教程必填，“主题标签”两类都必填。这样列表页可以按标签聚合，而不必为随笔硬塞难度。判断是否定得合理，看一个字段能否回答“没有它，读者或程序会不会出错”。会出错就设为必填，不会就设为可选。
实施阶段：内容按结构写，技术按结构实现
协作中最关键的一步，是内容作者在写正文时只使用约定好的标题层级和链接方式。技术一方则把这些结构映射到页面模板。双方不必互相等待，但必须共用同一份结构约定。
- 标题层级：一篇文章只用一个一级标题，小节用二级标题，小节内部才用三级标题。不要为了字号好看跳级。
- 链接：站内链接指向具体文章或栏目，锚文本写清楚目标内容，不写“点击这里”。
- 图片：每张图有说明文字，文件名能反映内容，不堆砌无关词。
- 摘要：单独写一段，不直接截取正文第一句，避免列表页出现半句话。
技术实现时，模板负责把标题、摘要、标签渲染到列表和详情页。如果内容作者临时加了一个未约定的字段，技术一方要么补模板，要么删字段，这就是返工来源。因此实施阶段要有一个“字段变更”记录，谁改了什么、影响哪些页面，写清楚再动手。
验证阶段：用检查项代替口头确认
验证不是看页面好不好看，而是看内容和技术是否对齐。可以按下面清单逐项检查：
- 打开一篇文章，确认标题层级没有跳级，正文中的二级标题能对应到目录或导航。
- 确认摘要、标签、作者、时间在列表页和详情页显示一致。
- 确认站内链接能打开目标页面，没有指向草稿或已删除内容。
- 确认图片有说明文字，页面在窄屏下不出现横向滚动。
- 确认页面源代码中，文章标题出现在
<h1>里，小节标题出现在<h2>里。
如果检查发现标题层级混乱，先判断是内容作者写错，还是模板把标题包错了标签。两种原因的修法不同：前者改正文，后者改模板。不要一看到问题就重写整篇。
维护阶段：把协作规则变成可复用的模板
博客上线后，协作不会自动变顺。每次新增栏目或改版，都可能让旧规则失效。维护的重点是保留一份“当前有效”的内容结构说明，并让新加入的人先读它再写第一篇。
可以每季度做一次小检查：随机抽三篇文章，看字段是否完整、链接是否有效、标题层级是否一致。发现同类问题重复出现，就把它写进模板或检查清单，而不是每次靠提醒。这样内容与技术协作会从“互相等”变成“按同一份清单交付”。
下一步，选一篇已发布的文章，按上面的验证清单逐项核对，把不符合的项改成约定结构，再把这次修改记录进协作说明。
