Skip to content
本页目录

平滑升级

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

这个过程繁琐又浪费时间,因此我们需要一种友好的更新方式。如果你也经历着这样的痛苦,那么不妨尝试 Hexo 3.0 新增的功能 -- 数据文件

Keep 主题利用该功能实现了平滑升级的特性,使用步骤如下: 将主题目录下的 _config.yml 文件复制到博客根目录下的 /source/_data/ 中,并重命名为 keep.yml。如果 source 目录下没有 _data 文件夹请自行创建。

image

这两个文件的关系为 keep.yml 覆盖 _config.yml,也就是说,想要修改配置时,只需要修改 keep.yml 里的即可(修改 _config.yml 里的不会生效)。这样就实现了平滑升级,更新 Keep 主题时 _config.yml (可能)会更新,而你的主题配置数据保留在 keep.yml 中。

注意

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

如果你使用了平滑升级这一特性,那么 /themes/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