平滑升级
更新 Hexo 主题时,一般都会有这样的经历:先将主题目录下的 _config.yml
文件备份,更新完主题后,再将备份的数据复制粘贴还原回去。
这个过程繁琐又浪费时间,因此我们使用一种友好的更新方式 —— Hexo 3.0 新增的 数据文件 功能。
Keep 主题利用该功能实现了平滑升级的特性,使用步骤如下:
将主题目录下的 _config.yml
文件复制到 Hexo 根目录下的 your-hexo/source/_data/
中,并重命名为 keep.yml
。如果 source
目录下没有 _data
文件夹请自行创建。
这两个文件的关系为 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 自带的代码对比工具:
值得庆幸的是 Hexo v5.0
之后,你也可以直接在 Hexo 项目根目录下创建 _config.keep.yml
文件来实现平滑升级。
这里作者依然推荐将主题配置文件放在 _data
文件夹中来实现平滑升级。