Skip to content

Upgrade to v2.0

Since all the hexo script and generators had being moved to a separate Hexo plugin package (hexo-plugin-aurora). Therefore the way we install Hexo Aurora Theme had changed since v2.x.

Step 1 - Upgrade Hexo and Hexo Plugins

If you are running an older version of Hexo package, make sure you upgrade it to the latest 6.x+.

If you are also using other hexo-plugins, make sure you also update them to the latest using the above method.

You can simply just add @latest behind the package name to get the latest one.

For example: yarn add hexo-filter-mathjax@latest

or just use the follow my package.json's dependencies config below (Last updated 26, July 2023):

json
...

"dependencies": {
  "hexo": "^6.3.0",
  "hexo-filter-mathjax": "^0.9.0",
  "hexo-generator-archive": "^2.0.0",
  "hexo-generator-category": "^2.0.0",
  "hexo-generator-index": "^3.0.0",
  "hexo-generator-tag": "^2.0.0",
  "hexo-plugin-aurora": "^1.2.0",
  "hexo-renderer-ejs": "^2.0.0",
  "hexo-renderer-marked": "^6.1.0",
  "hexo-renderer-stylus": "^3.0.0",
  "hexo-server": "^3.0.0",
  "hexo-theme-aurora": "^2.0.0"
}

...
...

"dependencies": {
  "hexo": "^6.3.0",
  "hexo-filter-mathjax": "^0.9.0",
  "hexo-generator-archive": "^2.0.0",
  "hexo-generator-category": "^2.0.0",
  "hexo-generator-index": "^3.0.0",
  "hexo-generator-tag": "^2.0.0",
  "hexo-plugin-aurora": "^1.2.0",
  "hexo-renderer-ejs": "^2.0.0",
  "hexo-renderer-marked": "^6.1.0",
  "hexo-renderer-stylus": "^3.0.0",
  "hexo-server": "^3.0.0",
  "hexo-theme-aurora": "^2.0.0"
}

...

Step 2 - Install latest Aurora Theme and Plugin

After you have upgrade all your Hexo related packages, now you can install the latest v2.x theme.

You can simply just run the following command.

Step 3 - Clean and Re-generate

After install the latest theme, you need to clean up the existing hexo data and regenerate it.

Simply run the below command:

shell
hexo clean && hexo generate
hexo clean && hexo generate

That's it for upgrading from 1.x to 2.x, enjoy!

Released under the MIT License.