2022年我的博客自动化流程

前言

2021 年的时候，写了一个篇 关于博客自动化 的文章，但是当时没有处理好 Craft 图片的问题，而且逻辑分散到多个仓库，不具有可参考性。在那之后验证了一下直接从 Craft 传图的可行性（答案是不行），于是最近花了一个周末搞定了一下图片转存到腾讯云的问题，加上换到了 Vercel 而不是用 Github Pages，速度变快了不少，遂记录如下。

注：可能后续还会有诸如「202x年我的博客自动化流程」之类的文章，毕竟技术在迭代，时代在进步，我也在折腾 🤣

正文

总体流程

详细解释

⓵ Craft 文档

指的是按特定格式写的博客文档，特定格式是指，需要满足以下条件，才能正确同步到仓库：

1. 文档的第一个元素是包含 meta 信息的 table元素。

2. meta 信息中，title 不用写，我直接从文档数据中获取，header-img 和 img 的版权信息（如果是从 unsplash 上传的）也不用写。

3. 不支持 Drawing 元素（因为它无法生成有效图片后缀名的文件），如果存在的话不会上传到 COS，会无法正常展示（因为它是 Craft 的私有文件类型） 。

⓶ Craft 插件仓库（公开）

指的是应用于 Craft 的插件，用来获取 Craft 文档内容，以将内容处理后上传到仓库。关于 Craft 插件的更多信息在 这里，关于我写的这个私有插件的地址在 这里。

插件的作用是将 Craft 的文档内容，生成 Markdown 格式的文档，然后使用 Github REST API 发送到固定的仓库位置，即 craft_publish_ci 仓库的 content.md 文件，如果该文件存在则会替换其内容，仓库地址公开，在 这里。

⓷ craft_publish_ci 仓库（公开）

此仓库主要使用 Github Action 来处理图片，接收到来自插件的内容之后（也即是 content.md 文件更新后），读取该文件的内容，将 Markdown 文件中的图片（以 ![ 开头的块级元素被判定为图片，以及特殊的 header-img 开头的头图）get 到之后转存在腾讯云 COS 中。其中，为了统一和方便，我拿到图片后会在 action 中统一转成 jpg 格式的，这样也好处理如果没有图片需要上传（仅修改文本）的时候，直接替换文档中图片地址的逻辑，因为有些图片后缀不是常用的图片格式如 png jpg，甚至没有后缀名等。我曾经尝试使用拉取图片的响应 content-type 来给图片添加后缀名，但是发现有些图片是 tiff 格式的，content-type 返回的是 application/octce-stream（没拼错的话），而且这个方案需要先全部拉取文档中的图片，怕被 ban，于是先将需要上传的都转成 jpg。然后拿到 CDN 地址后，将文档中对应的图片地址替换成 CDN 图片地址。完成之后再将文件内容发送到真正的博客仓库，也即 x_blog_src。

⓸ x_blog_src 仓库（私有）

此仓库接收到 push 更新后，执行 Action，build 出 HTML 文件，发送到博客公开仓库 x_blog，这么做的原因，详见 这里。

⓹ x_blog 仓库（公开）

此仓库 授权给 Vercel 读取其内容，然后部署。绑定了自定义域名，因此可以通过访问 www.xheldon.com 来访问。不使用 Github Pages 的原因是前者更专业，且有专门的全球 CDN 加速，而 Github Pages 一个是域名解析慢，一个是没有 CDN 加速，做个文档网站还好，做个博客没有任何优化感觉不合适。

其他细节

博客中存在异步请求 Notion 数据源的页面，如 订阅管理 页面，该过程同样是使用 Vercel 的 serverless，在服务端请求 Notion 的 database 做一层转发，这个接口我做成通用的了，使用 POST 发送 Notion database 的 表头 和 databaseId，方便我自己后续有更多的页面需要异步请求 Notion 的情况。

• 上一篇
  The Craft Markdown and The Github Markdown
• 下一篇
  【泡脚时间】第一期：为什么主流国产历史剧让人感觉非常假？