用 CMS 发布内容
在管理后台用中英文撰写、发布和整理博客文章、法务页面、更新日志与路线图。
CMS 模块在 /blog 发布博客(RSS 为 /blog/rss.xml),在 /legal/<slug> 发布法务页面,并提供 /changelog 和 /roadmap。每次保存都会保留一条修订并运行 SEO 检查。
准备工作
- 一个能在本地运行的项目,见快速开始。
cms模块已经在底座仓库里,入口是后台侧边栏 内容 分组下的 CMS。 - 管理员账号:
cms.read用于打开页面;新建或保存条目、新增分类术语还需要cms.write。Content Manager 角色同时包含两者。
页脚链接需要已发布的条目
公开页脚链接到 /blog、/legal/privacy 和 /legal/terms。安装后请发布 privacy 和 terms 两个法务条目,否则这些链接会进入未找到页面。
新建条目
开始新建
进入 内容 → CMS(/zh/admin/cms)。在 文章 标签页点击 新建内容,选择 类型:博客文章、页面、法务、更新日志、路线图 或 案例。类型创建后不能再修改。
填写字段
- 标题、摘要 和 Markdown:条目内容。Markdown 只渲染
#、##标题和段落。 - Slug:保存时转为小写,其他字符替换为连字符,
Launch Notes会保存为launch-notes。 - 语言:English 或 中文。中文条目显示在
/zh路径下。 - 分类 和 标签(用逗号分隔):自由填写。
- SEO 标题 和 SEO 描述。
- OG 图片:社交分享预览图的路径或 URL。留空则保留当前图片。
创建
点击 创建内容。条目会连同第一条修订一起保存,并在编辑器中打开。类型、Slug 和语言三者组合必须唯一;新建永远不会替换已有条目。
发布条目
打开条目
在对应标签页点击条目标题进入编辑器。路线图条目没有标签页,可直接打开 /zh/admin/cms/editor/cms_roadmap_<locale>_<slug>。
发布
把 状态 设为 已发布 并点击 保存内容,条目就会出现在对应语言的公开页面上。
改回 草稿 或 已归档 后,条目会从列表中移除,详情页显示未找到状态。首次发布时间会保留,重新发布时继续使用。每次保存都会记录一条修订,修订 卡片显示修订数量。
| 标签页 | 内容 |
|---|---|
| 文章 | 博客文章,发布在 /blog |
| 页面 | page 和 showcase 类型的条目 |
| 更新日志 | 发布在 /changelog 的条目 |
| 法务 | 发布在 /legal/<slug> 的条目 |
| 分类 | 分类、标签和模块及其使用次数 |
| SEO | 每次保存产生的检查结果 |
处理 SEO 警告
打开 SEO 标签页
每次保存都会为条目新增三项检查:SEO 标题 10 到 70 个字符、SEO 描述 50 到 160 个字符、Slug 为小写连字符格式。
修改后重新保存
未通过的检查显示 warn。在编辑器中调整对应字段后点击 保存内容。
新增分类术语
打开分类
打开 分类 标签页。
填写新增术语
选择 类型(分类、标签 或 模块)和 语言,填写 标签、Slug 以及可选的 描述。
保存
点击 新增术语。术语出现在表格中,使用次数统计分类或标签与该 slug 相同的条目。
验证
- 新建一篇 博客文章,把 状态 设为 已发布 并点击 保存内容。
- 中文条目打开
/zh/blog:文章出现在列表中,可以通过/zh/blog/<slug>访问,/zh/blog/rss.xml也包含它。 - 在仓库中运行
pnpm validate:cms。
常见问题
出现 "An entry with this type, locale and slug already exists."
新建内容 发现已有类型、语言和 slug 相同的条目。请从列表中打开已有条目,或换一个 slug。
出现 "CMS slug, locale, and type must be unique."
已有条目使用了相同的类型、slug 和语言。请修改 slug。
文章或法务页面显示未找到
条目是草稿或已归档,或者语言与 URL 不一致。把 状态 设为 已发布,并在 /zh 路径下访问中文条目。
条目没有出现在 /blog
列表只显示已发布且语言与 URL 一致的条目。中文条目出现在 /zh/blog,而不是 /blog。
显示「没有此 id 的内容。」
编辑器地址指向不存在的条目。请从列表中打开条目。