CMS与静态网页生成器的选择

在需要构建自己博客的时候使用开源的CMS或者静态网页生成器通常是最好的选择尤其是对于不喜欢JS的用户而言

CMS: Content Management System 内容管理平台一般会包含完整的前后端、权限管理和数据库整套的设施但是只是写一点静态内容的用户来说显得太臃肿了而且不是基于文本的内容不方便使用Git做版本管理不过有兴趣的话可以看看这里的推荐

那么优先排除掉了CMS 就进入了静态网页生成器的选择同时因为对于Markdown的偏好选出来了这份不错的候选单

在上面那份候选单之前我曾使用过一个JS库来构建博客: docsify 它的最大优势是不需要先生成静态网页而是运行时构建网页的方便早期不懂GitHub Action的时候作为过渡选项

不过运行时构建的代价就是首次打开特别慢文件越多越明显

VuePress

当我放弃 docsify 的时候发现了 VuePress 它看上去不错特别是刚好 VuePress@next (2.x-beta) 出了可以用TS来写一些配置文件

VuePress的优势在于

对于文档而言它足够了

不过对于博客而言它有点不对味

于是在内容多起来的时候并不能直接发现新增了什么这与博客放置新鲜内容的想法有些违背

放弃 VuePress 的原因主要有两点

VuePress 太像文档而不像博客切换到一个类似博客的主题需要重构代价太高
使用的 VuePress@next (2.x) 仍还是 beta 版本 blog timeline 风格插件不可用只有VuePress1.x版本可以用降版本就不能使用TS了

当时 VuePress 还有个问题就是它的特性好用到我不好做迁移所以在用 Jekyll 的时候就直接没有迁移原来的内容

这个时期之后便有了远离JS的想法候选单上的就只剩下 Jekyll 和 Hugo

然后简单看了一下 Hugo 的文档发现似乎整体比较复杂就先选了简单一点的 Jekyll (正好当时Ubuntu20.04自带了Ruby 所以就用了)

Jekyll有自己的Liquid语法能做一些比较复杂的事情但我并不需要我只需要简单的timeline

淘汰Jekyll的原因有点特别产生这个想法是因为将Ubuntu升级到22.04之后 Ruby/Gem 的那台工具依赖出问题了弄了半天还是不能本地build

其他的原因还有

在我重装系统使用Linux Mint之后系统没有自带Ruby 同时下载的docker镜像用于build再次出错后我将目光转向了Hugo

目前看来 Hugo 是一个不错的选择对于上述的Jekyll问题能有不错的解决能够满足我的初衷而且从Jekyll迁移不过不算特别麻烦

发现官方有相关内容: https://gohugo.io/tools/migrations/#jekyll 看了一眼似乎质量一般

建议先从主分支切分支出来操作先删除Jekyll的特有文件然后使用 hugo new site . --force 创建 Hugo 模板

最大的一个问题在于内容的迁移

一点基础的改动可以使用 migrate.py

其他对于 description 之类的改动只能手动操作或者手写脚本处理逻辑了

GitHub Action的部分可以直接使用Hugo官方文档中的内容

整个一套从 Jekyll 迁移过来大概用了2-3小时不算太长但还是有点折磨最后是希望一开始就找到能够满足需要的工具频繁的切换只是徒花时间