V1 示例文章。完整操作步骤见项目中的 DEPLOY.md。
内容先行
文章保存在 src/content/blog/。Astro 在构建时读取 Markdown 和 MDX,将它们转为 HTML。分类页、标签页和 RSS 也在这一步生成。
npm ci
npm run verify
npm run preview:workers
静态页面如何运行在 Workers 上
V1 使用 Workers Static Assets 托管 dist/。文章在构建时就准备好了,因此无需为每次阅读动态生成页面。
| 层次 | 职责 |
|---|---|
| Markdown / MDX | 保存内容 |
| Astro | 生成页面与订阅源 |
| Workers Static Assets | 分发构建产物 |
| GitHub Actions | 校验与可选部署 |
保持配置清晰
{
"name": "yinchaoji-blog",
"assets": { "directory": "./dist" }
}
这里仅展示核心配置。完整配置还包含 URL 规范化与 404 行为。
为下一步留出空间
如果未来需要登录、评论后端或按请求生成页面,再引入 Cloudflare 适配器与相应的存储绑定。当前版本先把阅读体验和写作流程做好。