温馨提醒

hexo-theme-solitude 即本主题在 v2.0.1 之后发布的所有版本均使用 Font Awesome 图标

如需要从低版本更新，请准备好备份。

安装

搭建 Hexo

如果你还没有 Hexo 博客，请按照 Hexo 官方文档 进行安装、建站。

作者的话

请仔细阅读文档，主题的使用在文档中都能找到，请先查找文档，不要浪费他人时间。

请注意 _config.solitude.yml 中的配置优先级大于主题的 _config.yml ，所以更新主题后需要比对主题文件夹中的 theme/solitude/_config.yml 文件内容，一般在 release 的说明里会特别提示或给出配置文件版本对比 diff，同步修改原配置文件即可。

本指南并未包含所有配置的说明，但几乎每个配置在主题配置中都有注释，你可以结合指南和注释一起参考使用。

此外，本指南仅包含主题范围内的使用说明。如果涉及到 Hexo 的使用或 Hexo 插件的使用，请参阅它们各自的文档。

若发现主题有 Bug 或者想要新增功能，请在 issues 留言，使用上的问题请在 Discussions 中提问。

主题安装

稳定版

git clone -b main https://github.com/everfu/hexo-theme-solitude.git themes/solitude

开发版

git clone -b dev https://github.com/everfu/hexo-theme-solitude.git themes/solitude

升级方法

git pull

应用主题

修改 hexo 根目录配置文件 _config.yml，把主题改为 solitude。​

theme: solitude

安装依赖

主题使用了 Pug 与 Stylus，需要额外安装各自的渲染器。

npm install hexo-renderer-pug hexo-renderer-stylus --save

语言配置

修改站点配置文件 _config.yml（不是主题配置文件）。

支持语言：en-US (美式英文) 、 zh-CN (简体中文)、zh-TW (繁体中文)

language: zh-CN # 语言

本地启动

hexo server

使用注意

如果遇到展示缓存问题，可以尝试 hexo clean 清除缓存再次启动。

优化配置

在博客根目录运行以下命令，将主题的配置文件复制到根目录，以便更好地配置主题。

Mac/Linux

cp -rf ./themes/solitude/_config.yml ./_config.solitude.yml

Windows

copy .\themes\solitude\_config.yml .\_config.solitude.yml

提示

• 根目录的 _config.solitude.yml 的配置都是高优先级，因此，渲染时会优先采用此文件的配置项内容。
• 在更新主题时可能会存在配置变更，请注意更新说明，可能需要手动对 _config.solitude.yml 同步修改。
• 想查看覆盖配置有没有生效，可以通过 hexo generate --debug 查看命令行输出。

版本号释义

本项目的版本号为 X.Y.Z 格式，但与常见的 语义化版本号规范 有部分区别，具体释义如下：

• X：产品层面的重新设计，包含重大框架重构，会涉及大范围功能变更与配置变更，更新前必须阅读相关文档
• Y：包含中大型新功能，及无法向下兼容的功能变更与配置变更，更新该版本号可能会需要修改配置或者移除一些原功能
• Z：不仅包含 BUG 修复、小型新功能，还会包含可以向下兼容的原功能更新与配置变更，原则上更新该版本号无需额外动作