Mondhttps://fuwari.vercel.app/zh_CNhttps://fuwari.vercel.app/posts/%E5%BB%BA%E8%AE%BE%E4%B8%AD/https://fuwari.vercel.app/posts/%E5%BB%BA%E8%AE%BE%E4%B8%AD/博客建设中Sat, 21 Mar 2026 00:00:00 GMT<hr /> <h1>Hello World! 👋</h1> <hr /> https://fuwari.vercel.app/posts/frontmatter/https://fuwari.vercel.app/posts/frontmatter/快速掌握 Fuwari 模板的文章元数据配置。Fri, 20 Mar 2026 00:00:00 GMT<p>在 Fuwari 模板中，每篇文章的开头都有几行被 <code>---</code> 包裹的代码，这叫 <strong>Frontmatter</strong>。它决定了文章的标题、日期、分类和封面图。如果配置错误，Cloudflare 构建时可能会报错。</p> <h2>1. 必填参数模板</h2> <p>新建文章时，请直接复制这段代码到 <code>.md</code> 文件最上方：</p> <pre><code>--- title: 这里写文章标题 published: 2026-03-20 description: 这里写文章简短摘要 image: '' tags: [标签1, 标签2] category: '分类名称' draft: false ---l:latest </code></pre> <h2>2. 关键参数详解</h2> <h3>标题与描述 (title &amp; description)</h3> <ul> <li><strong>title</strong>: 必填。会显示在网页标签和文章页顶部。</li> <li><strong>description</strong>: 建议填写。如果不填，列表页会显得很空。</li> </ul> <h3>发布日期 (published)</h3> <ul> <li><strong>格式</strong>: 必须严格遵守 <code>YYYY-MM-DD</code>（如 2026-03-20）。</li> <li><strong>注意</strong>: 如果填写的日期是“未来”，文章在部署后可能不会立即显示在首页。</li> </ul> <h3>封面图 (image)</h3> <ul> <li><strong>本地图片</strong>: 建议放在 <code>src/assets/images/</code> 目录下。 引用路径：<code>../../assets/images/文件名.png</code></li> <li><strong>外链图片</strong>: 直接填写完整的 URL 地址。</li> <li><strong>留空</strong>: 如果不需要封面图，请保持 <code>''</code>。</li> </ul> <h3>标签与分类 (tags &amp; category)</h3> <ul> <li><strong>tags</strong>: 必须用中括号包裹，例如 <code>[Docker, NAS]</code>。</li> <li><strong>category</strong>: 建议只写一个分类，用单引号包裹，例如 <code>'折腾记录'</code>。</li> </ul> <h3>草稿状态 (draft)</h3> <ul> <li><strong>false</strong>: 正常发布（默认）。</li> <li><strong>true</strong>: 设为草稿，访客在你的博客首页看不到这篇文章。</li> </ul> <hr /> <h2>3. 三大避坑守则</h2> <ol> <li><strong>冒号后必须有空格</strong>：例如 <code>title: 标题</code> 是对的，<code>title:标题</code> 会导致报错。</li> <li><strong>缩进要统一</strong>：YAML 语法对空格非常敏感，不要使用 Tab 键，统一使用空格。</li> <li><strong>特殊字符引号</strong>：如果标题里包含冒号 <code>:</code> 或引号 <code>"</code>，建议将整个标题用单引号包裹起来，例如：<code>title: '教程：如何配置 "Fuwari"'</code>。</li> </ol> <hr /> <h2>4. 快速发布流程</h2> <ol> <li>本地写好 <code>.md</code> 文件并检查 Frontmatter。</li> <li>上传至 GitHub 的 <code>src/content/posts/</code> 目录。</li> <li>等待 Cloudflare Pages 自动构建（约 1 分钟）。</li> <li>强制刷新域名（Ctrl + F5）查看效果。</li> </ol>