把喜欢的风景，放进小站里

横幅和头像可以自己换 #

小站的图片都在自己的项目里。首页横幅和头像的设置集中在 src/config/leafConfig.ts。

把喜欢的图片放到 src/assets/leaf 文件夹，然后在配置中导入它。横幅适合约 3:1 的宽图，左边留出简单的天空或海面，标题会更清楚；头像适合方图。

网站会自动生成 WebP 和不同尺寸的图片。原图保留在源码中，网页按屏幕大小选择合适的版本。

一篇文章，一个图片文件夹 #

建议把文章和图片放在一起：

posts/
  uart-notes/
    index.md
    images/
      wiring.png
      waveform.png

正文用标准 Markdown 插入图片，写一段清楚的替代说明。即使图片没有加载出来，也能知道它表达什么。

封面不是必填项。文章信息里的 image 留空，就会显示安静的纯文字卡片；想添加封面时，可以填写 ./images/cover.jpg。

文章配图放在 src/content 下。public 文件夹中的任何文件都会直接发布，不能把草稿图片或私人资料放在那里。

发布前看一眼 #

• 标题、摘要和分类是否合适。
• 代码能否读清楚，图片中的文字是否太小。
• 有没有账户、密钥、串口日志中的私人信息。
• 链接是否能打开，引用和图片是否标明了需要的来源。
• 手机上的段落和表格是否方便阅读。
• 只有准备公开的文章才写 draft: false。

网站更新的路径 #

本地保存内容，检查通过，然后提交并推送到 GitHub。Cloudflare Pages 完成构建后，新内容就会出现在网站上。

如果推送了内容却没有更新，先查看 Cloudflare 的部署状态。构建失败时，上一版成功的网站会继续提供访问。

这套流程不需要读者注册账户。写作和发布的权限，放在自己的电脑、GitHub 和 Cloudflare 账号中。