NexT Compatibility with Hexo Version
Version | Hexo 3.0.0-beta.4 or earlier | Hexo 3.0.0-rc.1 ~ 3.9 | Hexo 4.0 ~ 4.2.1 | Hexo 5.0 or later |
---|---|---|---|---|
NexT v0.4.5.1 or earlier | ✅ | ✅ | ❌ Icon (2) | ❌ Icon (2) |
NexT v0.4.5.2 ~ v7.4.1 | ⚠️ Data Files (1) | ✅ | ❌ Icon (2) | ❌ Icon (2) |
NexT v7.4.2 ~ v8.1.0 | ⚠️ Data Files (1) | ✅ | ✅ | ✅ |
NexT v8.2.0 or later | ⚠️ Nunjucks (3) | ⚠️ Nunjucks (3) | ⚠️ Nunjucks (3) | ✅ |
(1): Hexo 3.0.0-beta.4 or earlier does not support Data Files.
(2): Icons may not be displayed normally.
(3): Nunjucks renderer plugin required.
NexT Repositories
Due to historical reasons, NexT has three different repositories.
Years | Version | Repository |
---|---|---|
2014 ~ 2017 | v5 | https://github.com/iissnan/hexo-theme-next |
2018 ~ 2019 | v6 ~ v7 | https://github.com/theme-next/hexo-theme-next |
2020 | v8 | https://github.com/next-theme/hexo-theme-next |
Upgrade from Legacy Version
It’s recommended to upgrade NexT to version 8 to get the latest features and supports in the new Theme-Next repository.
Breaking Changes
There are some breaking changes that need attention when upgrading across versions.
Update language configuration (for Simplified Chinese)
Since v6.0.3,zh-Hans
has been renamed tozh-CN
: https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3Users upgrading to v6.0.3 and later need to explicitly modify the
language
configuration in Hexo config file, otherwise the language display is incorrect.Since v8.0.0, all libraries under the
next/source/lib
directory was moved out to @next-theme/plugins. Please see this article for the new 3rd-party libraries installation method: Adding Plugins.
Upgrade
So, NexT suggest to upgrade from version 5 or 7 to version 8 in this way:
- You need to do some copies of old NexT files:
1.1._config.yml
ornext.yml
(if you used Alternate Theme Config).
1.2. Custom CSS files placed innext/source/css/_custom/*
andnext/source/css/_variables/*
directories.
1.3. Custom layout files placed innext/layout/_custom/*
.
1.4. Any another possible custom additions which can be finded by compare tools between repositories. - Then rename the old NexT folder, for example, rename
next
tonext-old
. - Install the new version according to the method provided in this article: installation instructions. Run
hexo clean
andhexo s
to check whether the site works correctly. - Update Hexo and Hexo plugin
If after completing the above steps, an error occurs when executinghexo s
orhexo g
, it means that there may be a conflict between the old version of Hexo / Hexo plugin and the new version of the theme NexT. We recommend upgrading Hexo and Hexo plugins to the latest version. You can runnpm outdated
to see all the upgradeable plugins. - If you see any bugs or you simply does not like this version, you can switch back to the old version at any time.