个人博客从 Hexo 迁移至 Hugo

电脑升级 win 11 后，分盘操作存在 bug, 然后又不小心把装代码的盘格式化了，虽然都有备份到 github, 但是当时为了省事，hexo Node 安装的很多以来插件都没有备份，现在又下载不到了，所以 hexo 博客没办法完整复原，另外，早就觉得基于 Node 的 hexo 实在有些臃肿，且博客内容多了以后部署太慢，就干脆乘机换了好了，经过一段时间寻找，最终选择了基于 Go 的 hugo, 记录一下迁移过程及待办事项。

1 Hugo 准备

1.1 概念

Hugo is a fast and modern static site generator written in Go, and designed to make website creation fun again.

那 hugo 基于编译语言 GO 构建，对于静态页面的构建肯定是碾压 hexo 的存在，其官方标语也是很直白 "The world’s fastest framework for building websites", 作为先后使用过 hexo 和 hugo 的我来说，这确实名副其实。

• gohugo

1.2 安装

hugo 提供了很多种安装方式，Git, Docker, Binary.
个人电脑使用二进制安装是最方便快捷的，无需安装其他依赖。
到 Hugo Releases 下载对应的 windows 操作系统版本的 Hugo 二进制文件，玩就要玩全的，所以我就选择了扩展版本，此次选择的最新版为 hugo_extended_0.88.1_Windows-64bit.zip, 然后自行解压安装即可。

1.3 生成站点

使用 Hugo 快速生成站点，比如希望生成到 /path/to/site 路径：

1

hugo new site /path/to/site

站点目录结构：

▸ archetypes/    # 配置文章模板，相当于 hexo 的 scaffolds
▸ content/       # 文章页面内容，相当于 hexo 的 source
▸ data/          # 可存放一些 yaml, json, toml 格式的数据
▸ layouts/       # 页面布局源码，改造主题可不动主题源码
▸ static/        # 静态文件存放
  config.toml    # 站点配置文件，相当于 hexo 的 _config.yml

1.4 创建文章

注：路径要写以 content/ 为根目录的相对路径

1

hugo new path/fileName

1.5 添加主题

添加主题的方式选用 Git 子模组的形式，为了日后快速升级，避免在使用 hexo 中因大量魔改 next 主题而导致难以升级的困扰。
精挑细选最终选择了 LoveIt => FixIt

1
2

git init
git submodule add https://github.com/Lruihao/FixIt.git themes/FixIt

在 config.toml 添加 theme = “LoveIt”

1

theme = "FixIt"

1.6 在本地启动网站

使用以下命令启动网站：

1

hugo serve --disableFastRender

去查看 http://localhost:1313

1.7 hugo build

使用以下命令生成静态文件，然后自己可手动选择部署到 github pages 或 COS 等服务器

1

hugo --minify

2 写作指北

• FixIt 主题文档 - 基本概念
• FixIt 主题文档 - 内容
• FixIt 主题文档 - 内置 Shortcodes
• FixIt 主题文档 - 扩展 Shortcodes

3 Todo list

原来 hexo 做了大量的美化和扩展功能，迁移到 hugo 想尽可能多的保留。取之精华，去其糟粕。

3.1 Base

• 迁移 hexo 所有文章内容

• 迁移 hexo 所有页面内容

  • 留言页面
  • 网友打赏支持页面，整合到留言页面
  • 重写关于页面，一切从简
  • 友情链接页面
  • 重写 404 页面
  • 站点时间和不蒜子计数改到 hello-world 页面

• cos-album 和 🍚 饭醉团伙 🍷 整合到博客 cos-album/ #7 (wontfix)

• 新增 demo/, 以子模组的形式存放前端 demo, serverless 记账本等 （保持原本博客的纯粹性）

• 博客 valine 评论，阅读数迁移，可用 leancloud API 写代码转化（但似乎没必要）

• 博客 SEO 优化迁移 ^{baidu_urls.txt}

• Github actions 自动部署到 Github pages 和 COS 脚本编写

• hugo 本地管理 shell 脚本工具编写

• 知乎卡片式链接 改成 hugo shortcodes, 取名 cardlink

• zxm/沐目体 归档 :( #6

  • 安装 沐目体
  • 压缩 沐目体 fontspider
  • 沐目体 post 修订
  • typyit 配合 随机诗词和网易云热评 API
  • 实时预览功能 base on Vuejs
  • [恋爱叙事体] love 归档
  • [光] 归档

• hugo 内容加密研究 #3
• Lruihao/hugo-blog/README.md 撰写，MIT, 发布 1.0.0 版本做完整备份，base on theme version
• 更换 gravatar 头像 #4
• 博客在线编辑器研究 github1s 等 #5

[baidu_urls.txt]:↩︎

生成百度链接集合小技巧，关掉归档分页，在归档页面控制台执行以下代码即可获得所有文章链接

1
2
3
4
5

let urls = [];
for (let a of document.querySelectorAll('.archive-item a')) {
  urls.push(a.href);
}
console.log(urls.join('\n'));

FixIt 主题已支持自动输出 baidu_urls.txt 文件

3.2 Theme FixIt

hugo LoveIt 主题整体优化，必要时建 PR 或 issue 到 LoveIt 仓库 (LoveIt 已停更一年多）
先把自己发现和 LoveIt 原 repo 的 issue 尽可能的修复，修改的原则是：不改动原项目代码，
唯一途径就是在站点相同的目录用新增的方式替代修改、删除操作。
之后再等等看作者是否还会更新，如已做大量的更改，再做考虑整合为一个新的主题。
为了更好的完善博客功能以及修复 BUG 已创建新的主题 FixIt (fork from LoveIt)

进度更新至 #8

• CSS 优化，背景，元素圆角化，外圆内方，居中对齐等
• 沐目体引入
• TOC 序号生成
• Fix: 无标题时也会生成目录的 BUG
• subtitle 等细节优化
• Fix: typeit 打印代码时跑版的问题
• Fix: 文章 h1 标题多行跑版
• Code Review