hexo-theme-next/docs/zh-CN/DATA-FILES.md
2020-04-27 22:31:40 +08:00

2.8 KiB
Raw Blame History

配置文件

如何配置 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 中,然后\

  1. 所有这些配置项右移两个空格(在 Visual Studio Code 中:选中这些文字,CTRL + ])。\
  2. 在这些参数最上方添加一行 theme_config:

_config.[name].yml 方式

使用这一方式,你的主题配置将置于配置文件 /_config.[name].yml 中。这里的 [name] 需要替换为 Hexo 站点配置文件(/_config.yml)中 theme 项的名字,例如 next

如果在新的 release 中新增了选项,那么你只需要从 /themes/next/_config.yml 中将它们复制到此配置文件中并将它们的值设置为你想要的。

用法

  1. 请确认你的 Hexo 版本为 4.3 或更高。
  2. 根据你所使用的 NexT 主题的名字,在 Hexo 根目录下创建配置文件,例如 _config.next.yml
  3. 从主题的 /themes/next/_config.yml 文件中复制你需要的 NexT 配置项到此配置文件中。

next.yml 方式

较旧版本的 NexT 主题还提供了另一种配置方法,那就是将主题配置放置在 /source/_data/next.yml 文件中。这一方法已经废弃,请使用 _config.[name].yml 方式替代。如果存在 /source/_data/next.yml 文件,请将其移动到 Hexo 根目录并重命名为 _config.next.yml

相关链接