HandyControl/doc/themes/next/docs/zh-CN/DATA-FILES.md

数据文件

目前，通过 pull 或下载新的 release 版本来更新 NexT 主题的体验并不平滑。当用户使用 git pull 更新 NexT 主题时经常需要解决冲突问题，而在手动下载 release 版本时也经常需要手动合并配置。

现在来说，NexT 推荐用户存储部分配置在站点的 _config.yml 中，而另一部分在主题的 _config.yml 中。这一方式固然可用，但也有一些缺点：

1. 配置项被分裂为两部分；
2. 用户难以弄清何处存放配置选项。

为了解决这一问题，NexT 将利用 Hexo 的数据文件特性。因为数据文件是在 Hexo 3 中被引入，所以你需要更新至 Hexo 3.0 以后的版本来使用这一特性。

如果你仍然希望使用 Hexo 2.x，你依旧可以按老的方式进行配置。NexT 仍然兼容 Hexo 2.x（但可能会出现错误）。

选择 1：Hexo 方式

使用这一方式，你的全部配置都将置于 hexo 主要配置文件中（hexo/_config.yml），并且不需要修改 next/_config.yml，或者创建什么其他的文件。但是所有的主题选项必须放置在 theme_config 后，并全部增加两个空格的缩进。

如果在新的 release 中出现了任何新的选项，那么你只需要从 next/_config.yml 中将他们复制到 hexo/_config.yml 中并设置它们的值为你想要的选项。

用法

1. 请确认不存在 hexo/source/_data/next.yml 文件（如果已存在，请删除）
2. 从主题的 next/_config.yml 文件中复制你需要的 NexT 配置项到 hexo/_config.yml 中，然后
   2.1. 所有这些配置项右移两个空格（在 Visual Studio Code 中：选中这些文字，CTRL + ]）。
   2.2. 在这些参数最上方添加一行 theme_config:。

相关链接

• Hexo 配置
• Hexo Pull #757

选择 2: NexT 方式

使用这一方式，你现在可以将你的全部配置置于同一位置（source/_data/next.yml），并且不需要修改 next/_config.yml。 但是可能无法让所有 Hexo 外部库都准确处理它们的附加选项（举个例子，hexo-server 模块只会从 Hexo 默认配置文件中读取选项）。

如果在新的 release 中出现了任何新的选项，那么你只需要从 next/_config.yml 中将他们复制到 source/_data/next.yml 中并设置它们的值为你想要的选项。

用法

1. 请确认你的 Hexo 版本为 3.0 或更高。
2. 在你站点的 hexo/source/_data 目录创建一个 next.yml 文件（如果 _data 目录不存在，请创建之）。

以上步骤之后有 两种选择，请任选其一然后继续后面的步骤。

• 选择 1：override: false（默认）：

  1. 检查默认 NexT 配置中的 override 选项，必须设置为 false。
     在 next.yml 文件中，也要设置为 false，或者不定义此选项。
  2. 从站点的 _config.yml 与主题的 _config.yml 中复制你需要的选项到 hexo/source/_data/next.yml 中。

• 选择 2：override: true：

  1. 在 next.yml 中设置 override 选项为 true。
  2. 从 next/_config.yml 配置文件中复制所有的 NexT 主题选项到 hexo/source/_data/next.yml 中。

3. 然后，在站点的 hexo/_config.yml中需要定义 theme: next 选项（如果需要的话，source_dir: source）。
4. 使用标准参数来启动服务器，生成或部署（hexo clean && hexo g -d && hexo s）。

相关链接

• NexT Issue #328