风记WINDY NOTES

个人博客与「拾集」资源站的日常更新工作流

梳理本地维护「拾集」资源清单、撰写教程、验证测试到一键构建静态站点的完整流程。

文章目录

#整体思路:本地管理,静态发布

站点拆分为「写作与管理」和「公开静态站点」两层:

  1. 本地管理层:通过 npm.cmd start 启动本地 Node.js 服务,在浏览器里登录管理员账号,可视化添加或修改资源,保存到 data/resources.json。
  2. 静态发布层:通过 npm.cmd run build 把教程 Markdown 和公开资源清单打包进 dist/,不携带 data/accounts.json 或任何本地账号数据。

#日常更新的四个步骤

#1. 整理或更新资源清单

如果教程里要推荐工具,先确保它们已经收进 拾集资源页:

powershell
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. 运行自动化检查与本地预览

每次修改文章、资源或样式后,养成运行检查和预览的习惯:

powershell
npm.cmd test
npm.cmd run build
npm.cmd run preview

#4. 上传 dist/ 到 Cloudflare Pages

验证无误后,重新把 dist/ 上传到 Cloudflare Pages(控制台拖拽或 Wrangler CLI)即可完成线上更新。

本文关联的拾集资源

打开拾集资源页 ↗
开发工具stackblitz.com

StackBlitz

在浏览器中运行和编辑 Web 项目,快速实验代码、制作示例并分享开发环境。