2.8 KiB
配置文件
如何配置 Hexo 和 NexT?传统的做法是存储部分配置在 Hexo 站点配置文件(/_config.yml),而另一部分在主题配置文件(/themes/next/_config.yml)。这一方式固然可用,但通过 git pull 或下载新的 release 版本来更新 NexT 主题的体验并不平滑。当用户使用 git pull 更新 NexT 主题时经常需要解决冲突问题,而在手动下载 release 版本时也经常需要手动合并配置。对于新版本的 Hexo,主题可以通过 npm 安装;直接修改 node_modules 中的主题配置文件同样是困难的。
为了解决这一问题,Hexo 提供了以下这些方案。请任选其一,然后继续后面的步骤。
theme_config 方式
使用这一方式,你的全部配置都将置于 Hexo 站点配置文件(/_config.yml)中,并且不需要修改 /themes/next/_config.yml,或者创建什么其他的文件。但是所有用到的主题选项必须放置在 theme_config 后,并全部增加两个空格的缩进。
如果在新的 release 中新增了选项,那么你只需要从 /themes/next/_config.yml 中将它们复制到 /_config.yml 中并将它们的值设置为你想要的。
用法
从主题的 /themes/next/_config.yml 文件中复制你需要的 NexT 配置项到 /_config.yml 中,然后\
- 所有这些配置项右移两个空格(在 Visual Studio Code 中:选中这些文字,CTRL + ])。\
- 在这些参数最上方添加一行
theme_config:。
_config.[name].yml 方式
使用这一方式,你的主题配置将置于配置文件 /_config.[name].yml 中。这里的 [name] 需要替换为 Hexo 站点配置文件(/_config.yml)中 theme 项的名字,例如 next。
如果在新的 release 中新增了选项,那么你只需要从 /themes/next/_config.yml 中将它们复制到此配置文件中并将它们的值设置为你想要的。
用法
- 请确认你的 Hexo 版本为 4.3 或更高。
- 根据你所使用的 NexT 主题的名字,在 Hexo 根目录下创建配置文件,例如
_config.next.yml。 - 从主题的
/themes/next/_config.yml文件中复制你需要的 NexT 配置项到此配置文件中。
next.yml 方式
较旧版本的 NexT 主题还提供了另一种配置方法,那就是将主题配置放置在 /source/_data/next.yml 文件中。这一方法已经废弃,请使用 _config.[name].yml 方式替代。如果存在 /source/_data/next.yml 文件,请将其移动到 Hexo 根目录并重命名为 _config.next.yml。