NexT version 5 works fine with Hexo 3, but for frequent users, you maybe need to upgrade version 5 to 8 to get features and supports in new Theme-Next repository.
There are no hard breaking changes between 5.1.x and the latest version. It's change major version to 8 because:
- Main repositorie was rebased from iissnan's profile to next-theme organization.
- Most libraries under the
next/source/libdirectory was moved out to external repositories under NexT organization.
- 3rd-party plugin
hexo-wordcountwas replaced by
hexo-word-counterdoesn't have any external Node.js dependencies, nor language filter which causes better performance on speed at site generation.
So, NexT suggest to update from version 5 to version 8 in this way:
You don't touch old
nextdir and just do some copies of NexT files:
next.yml(if you used Alternate Theme Config).
1.2. Custom CSS styles what placed in
1.3. Custom layout styles what placed in
1.4. Any another possible custom additions which can be finded by compare tools between repositories.
Clone new repositorie to any another directory instead of
next. For example, in
git clone https://github.com/next-theme/hexo-theme-next themes/next-reloaded. So, you don't touch your old NexT 5.1.x directory and can work with new
Go to Hexo main config and set theme parameter:
theme: next-reloaded. So, your
next-reloadeddirectory must loading with your generation. If you may see any bugs or you simply not like this version, in anytime you can switch for 5.1.x version back.
Update language configuration (For Chinese)
zh-Hanshas been renamed to
Users upgrading to v6.0.3 and later need to explicitly modify the
languageconfiguration in the Hexo main config file
_config.yml, otherwise the language display is incorrect.
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 4.0 or later and upgrading Hexo plugins to the latest version. You can run
npm outdatedto see all the upgradeable plugins.
And how to enable 3rd-party libraries see here.