Upgrade Node.js to 10.13.0 or a newer version.
Install Icarus 4.0 either via source code dowload or NPM install. You can find instructions in Getting Started with Icarus. If you plan to customize the theme by altering its source code, you are required to install the theme from source code.
hexo cleanto clear cache files. Install any missing packages as prompted by Icarus:
ERROR Please install the missing dependencies your Hexo site root directory:
ERROR npm install --save [email protected]^5.0.2 [email protected]^0.8.2 [email protected]^2.0.0 [email protected]^2.2.0
ERROR yarn add [email protected]^5.0.2 [email protected]^0.8.2 [email protected]^2.0.0 [email protected]^2.2.0
hexo cleanagain to let Icarus upgrade your theme configuration file for you. Icarus will back up and remove
themes/icarus/_config.yml, and then create
_config.icarus.ymlas the new theme configuration file. You can refer to
_config.icarus.yml.examplefor example configurations.
WARN Your theme configuration is outdated (3.0.0 < 4.0.0).
INFO To skip the configuration upgrade, use "--icarus-dont-upgrade-config".
INFO Backing up theme configuration files...
INFO themes/icarus/_config.yml => themes/icarus/_config.yml.dc00f8b8f8bc03ede351d711e958dc4b
INFO Upgrading theme configurations...
INFO Theme configurations are written to /tmp/_config.icarus.yml.
INFO Example configurations is at /tmp/_config.icarus.yml.example.
Icarus now treats post thumbnails and cover images separately. For any posts/pages with an thumbnail image, change
cover:in the front-matter:
title: Getting Started with Icarus
- thumbnail: /gallery/covers/vector_landscape_1.svg
+ cover: /gallery/covers/vector_landscape_1.svg
You can still set
thumbnailin the front-matter to show a smaller thumbnail image for your posts in the archive page and in the recent post widget.