基于 Hexo + NexT + GitHub 的静态博客,2020 年 8 月升级过程记录

早在 2017 年,我基于 Hexo + NexT 搭建了 GitHub 托管的静态博客。到现在快 3 年了,发生了很多变化,比如 Hexo 脚手架升级了 2 个大版本「目前最新 5.0 版」,Node.js 也升级了多个大版本,静态博客的功能进行了很多增强,为了赶上时代的潮流,故需要对之前搭建的静态博客底层框架进行全方面的升级。本文记载了完整的升级过程。本文演示在 Mac 系统下的操作过程。

首先展示升级后,主页最终效果:

image

本次升级方案如下:

  1. 使用最新版脚手架工具创建新的静态博客项目
  2. 将文章、Next 主题、Hexo 配置等迁移至新版项目中

使用该方案,可确保不会出现新老版本的兼容性问题,在稳定性、效率之间找到最好的平衡点。

工具准备

根据 Hexo 官网的介绍,进行工具的准备,首先确保系统中已安装如下工具:

  1. node.js「演示版本13.12.0」
  2. git

而后在终端依次执行如下 bash 指令:

# 国内执行 cnpm 命令更快更方便
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

初始静态博客项目已经可以在本地运行起来了,接下来集成最新版 NexT 主题,根据 NexT 官网的指导,直接执行如下指令:

git clone https://github.com/theme-next/hexo-theme-next themes/next

打开 Hexo 配置文件,更改主题:

theme: next

安装 git 部署插件

npm install hexo-deployer-git --save

接下来可以开始准备数据的迁移工作了。

配置及文章迁移

只需要进行如下两步,即可完成迁移工作:

  1. 将 Hexo 目录下的 _config.yml 配置,以及主题目录下的 _config.yml 配置迁移至新的项目中
  2. 将 Hexo 目录下的 source 目录整体迁移至新的项目中

新版功能变更

  1. 在新版 NexT 主题的配置文件中,新增了很多基于 jsdelivr.net 的可选 CDN 服务,打开后可以保证三方资源文件的极快加载,建议打开。
  2. Hexo 的官方文档中,介绍了文章中插入图片的三种方法,不过无论是哪种方法,在使用本地 Markdown 编辑器进行文章编写时,都无法预览图片。为了解决此问题,可以安装一个图片路径转换的插件 hexo-asset-image,但是该插件目前处于废弃状态。目前未找到好的解决方法,暂时实用官网推荐的「相对路径的标签引用」。
  3. icon 资源的引用格式出现了变化,详情可以参考配置示例,需要注意变更。

感受

虽然 Hexo + NexT 整体升级了 1 到 2 个大版本,细节功能明显增加了很多「从配置的规模就可以看出来」,页面细节更加现代化,但是主体功能并无变化。首次迁移后,出现部分图片、图标找不到的情况,后续通过研究后都得到了解决,并无其他问题,体验相比原来达到了 105% 的水平,推荐升级。

参考链接

  1. Hexo 中完美插入本地图片
  2. Hexo 脚手架官网
  3. NexT 主题官网
阅读 399

推荐阅读

一个小小的码农,却有着一颗全栈的心,专栏分享 Java、Android、Vue.js、Python、C# 等等内容。

6 人关注
27 篇文章
专栏主页