Skip to content

平滑升级

更新 Hexo 主题时,一般都会有这样的经历:先将主题目录下的 _config.yml 文件备份,更新完主题后,再将备份的数据复制粘贴还原回去。

这个过程繁琐又浪费时间,因此我们使用一种友好的更新方式 —— Hexo 3.0 新增的 数据文件 功能。

Keep 主题利用该功能实现了平滑升级的特性,使用步骤如下:

将主题目录下的 _config.yml 文件复制到 Hexo 根目录下的 your-hexo/source/_data/ 中,并重命名为 keep.yml。如果 source 目录下没有 _data 文件夹请自行创建。

image

这两个文件的关系为 keep.yml 覆盖 _config.yml,也就是说,想要修改配置时,只需要修改 keep.yml 里的配置项即可(此时修改 _config.yml 里的不会生效)。

这样就实现了平滑升级,当你使用 NPM 或 Git 更新 Keep 主题时,主题配置文件 _config.yml (可能)会更新,而你的主题配置数据保留在 keep.yml 中,不会被影响。

注意

Keep 主题更新后,如果主题目录下的 _config.yml 文件里出现了新的配置项,那么你需要从该文件中将它们复制到 /source/_data/keep.yml 中,并设置它们的值为你想要的选项。

有时候,同步 /themes/keep/_config.yml/source/_data/keep.yml 两个配置文件里的内容也比较麻烦。因此,推荐使用代码对比工具进行查看,这样再进行同步就方便多了。例如 VS Code 自带的代码对比工具:

image

值得庆幸的是 Hexo v5.0 之后,你也可以直接在 Hexo 项目根目录下创建 _config.keep.yml 文件来实现平滑升级。

这里作者依然推荐将主题配置文件放在 _data 文件夹中来实现平滑升级。

Released under the AGPL-3.0 License