示例内容
[示例] 静态内容模型:让博客经得起迁移
用明确的内容 schema、纯文本源文件和构建期校验,示范如何降低长期写作的维护成本。
本文是排版与结构示例,不代表站点作者的真实项目、经历或观点。
长期写作真正昂贵的部分,往往不是第一版页面,而是几年之后仍能找到、修改并迁移旧文章。一个朴素的策略是:正文保留为 Markdown,元信息保持少而明确,页面在构建期生成。
从约束开始
内容字段不需要很多,但每个字段都应有用途:
| 字段 | 用途 | 是否必填 |
|---|---|---|
title |
列表、搜索与页面标题 | 是 |
description |
摘要与元描述 | 是 |
publishDate |
排序与归档 | 是 |
tags |
建立主题入口 | 是 |
draft |
控制发布状态 | 是 |
const article = {
title: '一篇可迁移的文章',
draft: false,
};
可读性也是技术指标
中文与 English terms 常常出现在同一段,例如 Static Site Generation、content collection 与构建缓存。合适的行宽、行高和代码滚动,比装饰性动效更直接地影响阅读。
最终目标不是消灭变化,而是让变化发生时,内容仍然清楚、完整、可导出。