Demo Sitehttps://www.sufuye.de5.net/enhttps://www.sufuye.de5.net/posts/hello-fuwari/https://www.sufuye.de5.net/posts/hello-fuwari/这是一篇示例文章，演示 Fuwari 博客的 frontmatter 格式与图片引用约定。Sat, 05 Sep 2026 00:00:00 GMT<p>欢迎来到你的新博客！这篇文章演示了 Fuwari 所需的全部 frontmatter 字段，以及图片的存放与引用方式。</p> <h2>frontmatter 字段说明</h2> <table> <thead> <tr> <th>字段</th> <th>必填</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td><code>title</code></td> <td>是</td> <td>文章标题，同时决定文章 URL 中的 slug</td> </tr> <tr> <td><code>published</code></td> <td>是</td> <td>发布日期（无引号的日期格式，如 <code>2026-09-05</code>）</td> </tr> <tr> <td><code>updated</code></td> <td>否</td> <td>最后更新日期</td> </tr> <tr> <td><code>description</code></td> <td>否</td> <td>摘要，显示在首页卡片和 RSS 中</td> </tr> <tr> <td><code>image</code></td> <td>否</td> <td>封面图片路径，统一放在 <code>public/attachments/</code></td> </tr> <tr> <td><code>tags</code></td> <td>否</td> <td>标签数组</td> </tr> <tr> <td><code>category</code></td> <td>否</td> <td>分类</td> </tr> <tr> <td><code>draft</code></td> <td>否</td> <td>设为 <code>true</code> 时文章不会出现在站点上</td> </tr> </tbody> </table> <h2>图片约定</h2> <p>所有图片统一放在仓库的 <code>public/attachments/</code> 目录，文章中以绝对路径引用（以 <code>/</code> 开头，指向站点根目录）：</p> <pre><code> </code></pre> <p>实际效果：</p> <p><img src="/attachments/in-post-demo.svg" alt="文章内插图" /></p> <p>Keystatic 后台（<code>/admin</code>）上传的封面图和正文图片也会自动存入 <code>public/attachments/</code> 并按上述方式引用。</p> <h2>在 Keystatic 后台写作</h2> <ol> <li>访问 <code>&lt;你的站点域名&gt;/admin/</code></li> <li>用 GitHub 账号登录（拥有仓库写权限的账号）</li> <li>点击「文章」集合 →「Create」即可新建文章，保存后 Keystatic 会自动向 GitHub 私有仓库提交 commit</li> <li>Cloudflare Pages 检测到新提交后会自动重新构建并发布</li> </ol> <blockquote> <p>[!TIP] 富文本编辑器右上角可以切换 Markdown 源码模式，直接编辑原始 Markdown。</p> </blockquote>