个人博客与「拾集」资源站的日常更新工作流
梳理本地维护「拾集」资源清单、撰写教程、验证测试到一键构建静态站点的完整流程。
#整体思路:本地管理,静态发布
站点拆分为「写作与管理」和「公开静态站点」两层:
- 本地管理层:通过
npm.cmd start启动本地 Node.js 服务,在浏览器里登录管理员账号,可视化添加或修改资源,保存到data/resources.json。 - 静态发布层:通过
npm.cmd run build把教程 Markdown 和公开资源清单打包进dist/,不携带data/accounts.json或任何本地账号数据。
#日常更新的四个步骤
#1. 整理或更新资源清单
如果教程里要推荐工具,先确保它们已经收进 拾集资源页:
npm.cmd start打开 http://127.0.0.1:4173/ 登录后即可可视化增改卡片。如果不方便配图或需要压缩素材,可以先到 拾集 · 在线工具 找现成工具处理。
#2. 新增一篇教程文章
在 content/posts/ 目录下新建一个 .md 文件,例如 my-first-tutorial.md。文件顶部写好 Frontmatter 元数据,正文中可以直接用站内链接跳到拾集页面,例如:
- 跳转到特定分类:
[查看设计素材](/resources/?category=设计素材) - 跳转到多标签交集:
[查看开发协作工具](/resources/?tag=开发&tag=协作) - 跳转到关键词搜索:
[搜索白板工具](/resources/?q=白板)
#3. 运行自动化检查与本地预览
每次修改文章、资源或样式后,养成运行检查和预览的习惯:
npm.cmd test
npm.cmd run build
npm.cmd run preview#4. 上传 dist/ 到 Cloudflare Pages
验证无误后,重新把 dist/ 上传到 Cloudflare Pages(控制台拖拽或 Wrangler CLI)即可完成线上更新。