41 lines
2.9 KiB
Markdown
41 lines
2.9 KiB
Markdown
<h1 align="center">从 NexT v5.1.x 更新</h1>
|
||
|
||
在使用 Hexo 3 时，NexT V5 版本仍然能够正常运行，但是如果你想获得更多的功能和帮助，还是建议您升级到 NexT V7+ 版本，并移步 [Theme-Next](https://github.com/theme-next/hexo-theme-next) 仓库。
|
||
|
||
在 5.1.x 版本和新版本之间没有很大的革命性改进。主版本号变更至 7 主要是因为：
|
||
|
||
1. 主仓库已从 [iissnan 名下](https://github.com/iissnan/hexo-theme-next) 迁移至 [theme-next](https://github.com/theme-next) 组织。
|
||
2. `next/source/lib` 目录下的绝大多数库被移出到了 [NexT 组织的外部仓库](https://github.com/theme-next)中。
|
||
3. 第三方插件 [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) 被 [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) 所取代，因为 `hexo-symbols-count-time` 没有任何外部 Node.js 依赖、也没有会导致生成站点时的性能问题 [language filter](https://github.com/willin/hexo-wordcount/issues/7)。
|
||
|
||
我们推荐通过如下步骤从 v5 升级到 v7：
|
||
|
||
1. 并不修改原有的 `next` 目录，而只是复制部分 NexT 文件：
|
||
1. `_config.yml` 或 `next.yml`（如果你使用了[数据文件](DATA-FILES.md)）。
|
||
2. 自定义的 CSS 配置，它们应在 `next/source/css/_custom/*` 和 `next/source/css/_variables/*` 中。
|
||
3. 自定义的排布配置，它们应在 `next/layout/_custom/*` 中。
|
||
4. 任何其它可能的附加自定义内容；为了定位它们，你可以通过某些工具在仓库间比较。
|
||
2. 克隆新的仓库到任一异于 `next` 的目录（如 `next-reloaded`）：
|
||
```sh
|
||
$ git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded
|
||
```
|
||
如此，你可以在不修改原有的 NexT v5.1.x 目录的同时使用 `next-reloaded` 目录中的新版本主题。
|
||
3. 在 Hexo 的主配置文件中设置主题：
|
||
```yml
|
||
...
|
||
theme: next-reloaded
|
||
...
|
||
```
|
||
如此，你的 `next-reloaded` 主题将在生成站点时被加载。如果你遇到了任何错误、或只是不喜欢这一新版本，你可以随时切换回旧的 v5.1.x 版本。
|
||
|
||
4. 更新语言配置
|
||
|
||
从 v6.0.3 版本起，`zh-Hans` 改名为 `zh-CN`：https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3
|
||
|
||
升级到 v6.0.3 及以后版本的用户，需要显式修改 Hexo 主配置文件 `_config.yml` 里的 `language` 配置，否则语言显示不正确。
|
||
5. 更新 Hexo 和 Hexo 插件
|
||
|
||
如果完成了以上步骤后，执行 `hexo s` 或 `hexo g` 出现错误，这意味着可能是旧版的 Hexo 和 Hexo 插件与新版的 NexT 主题产生了冲突。我们建议将 Hexo 升级至 4.0 以上的版本，将 Hexo 插件升级到最新版本。你可以执行 `npm outdated` 查看所有可以升级的插件。
|
||
|
||
关于第三方库的启用，参见[这里](https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md#插件)。
|