Solitude Docs

Installation

Install Hexo and the Solitude theme, then prepare the theme configuration.

Prerequisites

Install Node.js and make sure your package manager is available. Hexo and Solitude run inside a Hexo blog directory, so create or open that project before installing the theme.

Install Hexo CLI

npm install -g hexo-cli
hexo init my-blog
cd my-blog
npm install

Install the theme

Choose one installation method. NPM is easier to update; Git is convenient when you want to inspect or customize the theme source.

npm install hexo-theme-solitude
git clone https://github.com/everfu/hexo-theme-solitude.git themes/solitude

Enable the theme

Set the theme name in Hexo's root configuration.

# _config.yml
theme: solitude

Prepare the theme configuration

Copy the theme configuration into the blog root and keep local edits there.

cp node_modules/hexo-theme-solitude/_config.yml _config.solitude.yml

For Git installation, copy from the theme directory instead:

cp themes/solitude/_config.yml _config.solitude.yml

Expected structure

Blog Directory
_config.yml
_config.solitude.yml
source
themes

Keep custom theme settings in the blog root. This makes theme upgrades less risky because your local configuration is not mixed with package files.