Hexo Theme Solitude

Hexo Theme Solitude is a designer-style Hexo blogging theme that combines Pjax page lazy loading, LazyLoad image loading, PWA offline support, LaTeX math rendering, and up to five comment systems in a single npm-installable package. Created by 伍十七 (everfu) with theme design authorized by 张洪 Heo, the theme is distributed through npm as hexo-theme-solitude and targets Hexo 7.0.0+ with Node 14.0.0+.

What is Hexo Theme Solitude?

Hexo Theme Solitude is a Hexo static site generator theme that turns standard Hexo blog content into a designer-styled site with built-in performance and engagement features. It takes Hexo's post/page Markdown files as input and outputs a rendered blog with special pages such as 即刻短文 (instant notes), 我的装备 (my gear), 在线工具 (online tools), 音乐馆 (music hall), 友链鱼塘 (friend-link pond), 相册 (gallery), 豆瓣 (Douban), and 弹幕留言 (danmaku messages). The project is licensed under Apache-2.0 and maintained by 伍十七.

Key Features

• Lazy loading & PWA — Pjax for page navigation without full reloads, LazyLoad for images, and offline application support via PWA.
• Multiple comment engines — Native support for Twikoo, Waline, Valine, Artalk, and Giscus, including dual-comment configuration.
• Color mode toggle — Automatic day/night switching with manual control.
• Lightbox integration — Choose between medium-zoom and fancybox for image viewing.
• LaTeX math — Renders mathematical formulas in posts using LaTeX syntax.
• Special pages included — Eight unique page templates: instant notes, gear list, online tools, music gallery, blogroll, photo gallery, Douban widget, and danmaku comment wall.
• Article enhancements — AI-generated article summaries and syntax-highlighted code blocks.
• Browser extension API — Exposes window.Solitude with navigate(), refresh(), copy(), toggleTheme(), loadScript(), loadStyle(), and an on() event system for ready, beforeNavigate, afterNavigate, and themeChange events, replacing the legacy sco, utils, pjax, GLOBAL_CONFIG, and PAGE_CONFIG.

Who should use Hexo Theme Solitude?

Hexo bloggers who want a visually polished, feature-rich theme without assembling many plugins. Developers who want to extend their blog through the documented window.Solitude API. Writers who need LaTeX math rendering and robust comment moderation via Giscus or Artalk. Users who want multilingual documentation — the README is provided in English, Simplified Chinese, Traditional Chinese, and Spanish.

Use cases

• Personal bloggers: build a personal blog on Hexo that loads quickly thanks to Pjax and PWA, with comments powered by Twikoo or Waline.
• Photographers: use the built-in gallery page and medium-zoom/fancybox lightbox to present image portfolios.
• Tech writers: write LaTeX-heavy posts that render correctly, and integrate Giscus for GitHub-based comments.
• Creative coders: hook into the window.Solitude API to add custom navigation, theming, and script loading behaviors.

How to use Hexo Theme Solitude?

Install the npm package with npm i hexo-theme-solitude, then set theme: solitude in your Hexo _config.yml. Full documentation is available at https://solitude.js.org/. Community support is available via Discord and a QQ group (948375336).

FAQ

Is Hexo Theme Solitude free?

Yes, the theme is open-source under the Apache-2.0 license. It's available for free on npm as hexo-theme-solitude.

Which Hexo and Node versions are required?

Hexo Theme Solitude requires Hexo 7.0.0 or later and Node.js 14.0.0 or later.

What comment systems can I use?

You can choose between Twikoo, Waline, Valine, Artalk, and Giscus. The theme also supports dual-comment setup so two systems can run side by side.

Does the theme support dark mode?

Yes, it includes ColorMode with day/night toggle, and the window.Solitude.toggleTheme() API lets custom scripts switch themes programmatically.

Where can I find the documentation?

The official docs live at https://solitude.js.org/. The repository also includes community links via Discord and QQ.