缘起
无意中看到一个博客，主题非常好看，第一眼就喜欢上了。
这是一个 Hugo 博客主题，作者 CaiJimmy ，在 Github 上有 4.3K 的 Star 。
主题风格像谷歌的 Material You，我搜了 Wordpres 相关的主题，都是旧的 Material Design 2 的主题，如 MDx ，不如新的好看，而且大多不维护了。
很神奇的事是，作为最被广泛使用的博客平台 Wordpress ，没人移植这个主题，反而比较小众的 Halo ，有人移植了。
尝试 Halo
为了用上喜欢的主题，我决定试一下 Halo 。
Halo 部署起来非常方便，两三下就搞定了，把 Wordpress 文章导入 Halo 后发现不对劲了。
我在 WP 中使用的固定链接格式是 https://umi.im/post ，这样很简洁。
而 Halo 无法设置这种固定链接，会在文章名前面加上 ?p= 符号，导致 URL 变成 https://umi.im/?p=post ，这会影响网站的 SEO 。
还有一点，Halo 后端用 JAVA 编写，我不懂编程，但我知道用了 JAVA 的程序都很吃资源…
事实也如此，对比我使用了 Redis 和 WP Rocket 做了页面缓存的 WP 博客，Halo 速度反而更慢了。
所以，我放弃了。
告别 Wordpress
这个 WP 博客已经运行十多年了，讲真，我不太喜欢它。
我的 VPS 都是单核 1GB 内存的，运行起来真的很吃力，编辑器很难用，让人没有写博客的欲望。
最最最重要的是，WP 实在缺好看的个人博客主题。Argon-Theme 是我为数不多喜欢的，可惜作者已经弃坑，就趁着这机会迁移到 Hugo 吧。
存图纪念一下，感谢 archive.org 。
迁移博客
转换并导出 WP 文章与评论
先做好数据库备份，停用各种插件，再在 Wordpress 自带的导出里导出 .xml 格式的备份，等下需要它来迁移评论数据。
去 Github 下载 WordPress to Hugo Exporter ，导入 WP 并安装。
SSH 连接主机，进入插件目录，运行 php hugo-export-cli.php /home 导出，直接报错。
|
|
我问了 ChatGPT ，它给了很多愚蠢的回答，害我折腾了几小时。
直接谷歌第一个链接就解决问题，把 PHP 8.3 换成 PHP 8.0 就不会报错了。
导入文章并本机测试
参考 Hugo：Stack主题- 建站指南 这篇教程，在 Windows 上安装 Hugo 和配置 Stack 主题。
把 Wordpress 导出文件拉回本机解压，以我导出的文件为例。
wp-content 是 WP 的文件目录，主要是图片，把它拷贝到 Hugo 的 content 目录。
posts 目录内的是转换成 Markdown 格式的 WP 文章，拷贝到 content/post 目录。
剩下的几个目录是我的 WP 页面，拷贝到 content/page 目录，config.yaml 记录了网站名和描述，这个不用拷贝过去，用 Stack 主题自带的 exampleSite 配置 config.yaml 就行。
拷贝完文件后运行 hugo server 在本机检查有没有问题。
wordpress-to-hugo-exporter 插件导出文章可能会有些没转换好格式，需要手动修改。
反正先慢慢摸索，大概把 Hugo 玩明白了再部署网站。
在 VPS 上部署 Hugo
像 Hexo 和 Hugo 这种静态博客，使用者大多是程序员，Hugo 博客大多数是部署在 Github Pages 上的。
我不懂编程，也不会用 Git ，但我的 VPS 性能还不错，并且是 CN2GIA 线路的，所以我选择部署自己 VPS 上，在中国大陆的访问速度会比 Github Pages 更快。
Debian 安装 Hugo
APT 安装的版本较老，所以去 Github 直接下载 .deb 包安装，要下载 extended 版本。
|
|
安装完成后检查版本。
|
|
运行 Hugo
把本机的 hugo 博客目录打包上传到 VPS 上，在 hugo 目录运行：
hugo server --appendPort=false --baseURL="https://umi.im"
如果不加 –appendPort 参数会导致搜索无法使用。
运行后会在 hugo 目录生成 public 目录，用 Nginx 配置的静态网站指向这个目录，再配置好证书就可以访问了。
评论系统
部署 Waline
因为是静态网页，所以需要评论功能的话要引入第三方评论系统，这里我选择 Waline ，一款简洁、安全的评论系统。
Waline 官方推荐部署在 Vercel 这种 PaaS 平台，参考 Waline 快速上手 ，文档写得很详细。
迁移评论
不过 Waline 本身并不支持导入 Wordpress 的评论，这里需要用到 ceeji 大佬写的脚本，把 Wordpress 导出的 .xml 备份文件转成可以导入 Waline 的 .json 文件。
参考 从 Wordpress 评论迁移到 Waline 这篇文章。
不过把转换好后台导入后发现 URL 有问题。
需要把 url 字段的域名去掉，例如我需要批量把 “url”: “https://umi.im/about/" 改成 “url”: “/about/” ，然后再重新导入 Waline 。
1500多条评论成功迁移。
同步
成功部署到 VPS 后发现想修改文章或者主题有点麻烦，可能这也是更多人选择用 Github 部署的原因吧。
为了方便，我安装了 Syncthing 在服务器和本机上双向同步 Hugo 目录。
这样修改了内容基本秒是同步的，记得排除掉 VPS 的 public/* 目录。
Hugo 的使用体验
一个字，快！
才发现自己的网站也可以这么快！没有 Wordpress 这种便秘的感觉了。
用 Typora 在本机写东西也很舒服。
