Solitude Docs

Introduction

Understand Solitude 4, its requirements, and its configuration model.

What Solitude 4 is

Solitude 4 is a Hexo theme for personal blogs. It provides homepage modules, post metadata, sidebars, feature pages, search, comments, PWA support, and a browser extension API.

Version 4 rebuilds the browser runtime around native ES modules. Search, music, links, the context menu, translation, post AI, and cover colors are loaded only when their configuration enables them. A unified PJAX lifecycle cleans up page listeners and third-party instances between navigations.

Requirements

  • Hexo 7.0.0 or newer.
  • Node.js 14.0.0 or newer.
  • A recent Chrome, Edge, Firefox, or Safari release. Internet Explorer is not supported.

Configuration files

_config.yml in the blog root controls Hexo itself: title, author, URL, language, and the selected theme. _config.solitude.yml controls Solitude modules and appearance.

my-blog/
  _config.yml
  _config.solitude.yml
  source/
  themes/solitude/   # Git installation only

The examples in these docs target Solitude v4.0.0. Keep the upstream v4 configuration nearby when merging a configuration created for 3.x.