Hexo blog | 11it

icon

password

💡

hexo 博客现在已经不在更新维护，本文只做记录归档使用

背景

最近在整理资料时，发现2年前备份的hexo 网站的 md 源文件，才发现，自己的个人站点，已经2年多没有更新了，上次更新还是在2020年，在前司的办公电脑上操作的。趁着最近整理资料的契机，将个人博客重新部署、升级。

目标

迁移 hexo 源文件、配置

升级hexo 版本、Next 主题版本

CI/CD ,github page 自动更新 ^832567

hexo 源文件，相关的配置备份;源文件多端同步，能够在不同的电脑、终端编辑博客

多平台发布

hexo博客

微信公众号

hexo 文件迁移

翻箱倒柜，从移动硬盘上找到了3年前备份的hexo目录，当时保险起见，把整个安装包备份了下来。hexo 博客下面几个目录/文件比较关键，只要这几个东西在，就能快速的重新把hexo搭建起来。

config 配置文件

theme 中的主题配置文件

package.json node 依赖

把之前备份的整个目录 copy 到现在电脑上，删除 node_modules 目录

执行 npm install 安装相关依赖

npm install hexo-cli-g

hexo server , 惊喜的发现，本地可以直接运行起来。有一个多语言适配的问题，后面再解决。

hexo 版本升级

hexo 版本升级过程比较简单，主要是更新相关的依赖内容升级之前的版本信息

看了下 hexo 官网最新的版本已经升级到了 6.3。升级过程如下

Next 版本升级

主题的升级过程稍显复杂，Next 主题从 7.8 版本升级到最新的 8.2 , 中间有 break changes，有一些配置文件需要手动 copy。升级步骤参Next官方文档。

[!NOTE] Breakking Changes There are some breaking changes that need attention when upgrading across versions.
Update language configuration (for Simplified Chinese) Since v6.0.3, zh-Hans has been renamed to zh-CN: https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3 Users upgrading to v6.0.3 and later need to explicitly modify the language configuration in Hexo config file, otherwise the language display is incorrect.
Since v8.0.0, all libraries under the next/source/lib directory was moved out to @next-theme/plugins. Please see this article for the new 3rd-party libraries installation method: Adding Plugins.

[!NOTE] Next 主题官方升级步骤 NexT suggest to upgrade from version 5 or 7 to version 8 in this way:
You need to do some copies of old NexT files: 1.1. _config.yml or next.yml (if you used Alternate Theme Config). 1.2. Custom CSS files placed in next/source/css/_custom/* and next/source/css/_variables/* directories. 1.3. Custom layout files placed in next/layout/_custom/*. 1.4. Any another possible custom additions which can be found by compare tools between repositories.
Then rename the old NexT folder, for example, rename next to next-old.
Install the new version according to the method provided in this article: installation instructions. Run hexo clean and hexo s to check whether the site works correctly.
Update Hexo and Hexo plugin If after completing the above steps, an error occurs when executing hexo s or hexo g, it means that there may be a conflict between the old version of Hexo / Hexo plugin and the new version of the theme NexT. We recommend upgrading Hexo and Hexo plugins to the latest version. You can run npm outdated to see all the upgradeable plugins.
If you see any bugs or you simply does not like this version, you can switch back to the old version at any time.