Solitude Docs

Introduction

Understand Solitude's theme model, modules, and configuration entry points.

What Solitude is

Solitude is a Hexo theme for personal blogs, focused on a calm reading experience, clear information hierarchy, and feature modules that can be enabled as needed. It controls the blog's appearance, article layout, page components, navigation, and third-party integrations. It is not a standalone site generator.

What the theme provides

  • Homepage sections such as top banners, recommendations, category entries, notices, and content groups.
  • Post page elements such as table of contents, copyright blocks, previous and next posts, tags, categories, and reading metadata.
  • Sidebar modules such as profile cards, site statistics, tags, table of contents, and custom widgets.
  • Feature pages such as About, Links, Gallery, Music, Bangumi, Equipment, and Message.
  • Search and comment integrations including local search, Algolia, DocSearch, Twikoo, Waline, Artalk, Giscus, and Valine.

Configuration entry points

Solitude's theme options live in _config.solitude.yml. The Hexo root _config.yml still handles site title, URLs, language, theme name, and other Hexo behavior. Theme modules, appearance, pages, comments, and search are configured through Solitude.

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

Where to go next

If the theme is not installed yet, continue with installation and first run. If your blog already starts correctly, jump into the configuration chapters and adjust the theme by area: homepage, navigation, sidebar, posts, appearance, SEO, and more. Feature pages and third-party integrations can be enabled only when you need them.

These docs describe the Solitude theme itself: its features, configuration fields, and usage patterns. They do not document how this documentation site was built.