325 words
2 minutes
你好,Fuwari!
欢迎来到你的新博客!这篇文章演示了 Fuwari 所需的全部 frontmatter 字段,以及图片的存放与引用方式。
frontmatter 字段说明
| 字段 | 必填 | 说明 |
|---|---|---|
title | 是 | 文章标题,同时决定文章 URL 中的 slug |
published | 是 | 发布日期(无引号的日期格式,如 2026-09-05) |
updated | 否 | 最后更新日期 |
description | 否 | 摘要,显示在首页卡片和 RSS 中 |
image | 否 | 封面图片路径,统一放在 public/attachments/ |
tags | 否 | 标签数组 |
category | 否 | 分类 |
draft | 否 | 设为 true 时文章不会出现在站点上 |
图片约定
所有图片统一放在仓库的 public/attachments/ 目录,文章中以绝对路径引用(以 / 开头,指向站点根目录):
实际效果:
Keystatic 后台(/admin)上传的封面图和正文图片也会自动存入 public/attachments/ 并按上述方式引用。
在 Keystatic 后台写作
- 访问
<你的站点域名>/admin/ - 用 GitHub 账号登录(拥有仓库写权限的账号)
- 点击「文章」集合 →「Create」即可新建文章,保存后 Keystatic 会自动向 GitHub 私有仓库提交 commit
- Cloudflare Pages 检测到新提交后会自动重新构建并发布
TIP富文本编辑器右上角可以切换 Markdown 源码模式,直接编辑原始 Markdown。