|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.
Due to historical reasons, NexT has three different repositories.
|2014 ~ 2017||v5||https://github.com/iissnan/hexo-theme-next|
|2018 ~ 2019||v6 ~ v7||https://github.com/theme-next/hexo-theme-next|
It's recommended to upgrade NexT to version 8 to get the latest features and supports in the new Theme-Next repository.
There are some breaking changes that need attention when upgrading across versions.
Update language configuration (for Simplified Chinese)
zh-Hanshas been renamed to
Users upgrading to v6.0.3 and later need to explicitly modify the
languageconfiguration in site config file, otherwise the language display is incorrect.
Since v8.0.0, all libraries under the
next/source/libdirectory was moved out to @next-theme/plugins. Please see this article for the new 3rd-party libraries installation method: Adding Plugins.
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:
next.yml(if you used Alternate Theme Config).
1.2. Custom CSS files placed in
1.3. Custom layout files placed in
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
- Install the new version according to the method provided in this article: installation instructions. Run
hexo sto check whether the site works correctly.
- Update Hexo and Hexo plugin
If after completing the above steps, an error occurs when executing
hexo 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 to versions 5.0 or later and upgrading Hexo plugins to the latest version. You can run
npm outdatedto 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.