跳到主要内容

建站日志 02：技术选型与发布流程

博客希望长期用 Markdown 写作，也希望挑选好内容后能方便地发布。最后确定的组合是 Docusaurus、本地发布助手、GitHub 和 Cloudflare Pages。

为什么选择这套方案​

Docusaurus 可以将 Markdown 文章构建成静态网站，并提供文章页面等基础能力。对于主要用于记录和阅读的博客，这让第一版不必先搭建数据库和后台服务。

GitHub 私有仓库存放博客源码和选定发布的文章；Cloudflare Pages 连接仓库，在收到更新后构建网站。仓库私有，网站仍然可以公开访问。

从笔记到网站​

文章的路径大致是：

本地 Markdown 笔记
  → 挑选文章并填写元信息
  → 保存博客用的副本
  → 提交并推送到 GitHub
  → Cloudflare Pages 构建和发布

这里有一个重要区别：推送成功只表示代码到了 GitHub，不等于网站已经更新。 Cloudflare 还要完成构建和部署，最后还需要访问网站检查。

本地发布助手​

为了减少手工整理，项目做了一个只在本机运行的发布助手。它提供界面，选择 Markdown 文件后，可以填写标题、地址、日期、分类、标签和摘要，并生成预览。

对目前支持的本地图片，助手会复制资源并调整发布副本中的路径。原始学习笔记不需要因为发布而被改写。确认后，助手可以提交本次选择的内容并推送。

目前标准 Markdown 图片写法有支持；引用式图片和 HTML 图片尚不支持。已发布文章的图形化更新流程也还需要完善。

地址和部署状态​

最初使用的 Pages 地址包含旧项目名，后来迁移到 ranjian.pages.dev。仓库记录显示，新 Pages 项目连接了同一个仓库；具体每次部署是否成功，仍应以对应版本和实际页面检查为准。

这套流程让写作继续留在本地，也为以后改善发布体验留下空间。