安装 Solitude 主题（三种方式任选，推荐第一种）

Solitude 是一个极简而优雅的 Hexo 主题，专为开发人员和作家设计。

1.安装solitude

方式 1：Git 安装

  1. 在命令行里粘贴下面的命令，按回车：
1
2
git clone -b dev https://github.com/everfu/hexo-theme-solitude.git themes/solitude

  • 等待下载完成，博客文件夹里的 “themes” 目录下会多出一个 “solitude” 文件夹，说明主题下载成功了。

方式 2：直接下载文件安装（没装 Git 可选）

  1. 打开链接https://github.com/everfu/hexo-theme-solitude/releases，下载最新版本的压缩包（带 “release” 字样的）。
  2. 找到下载的压缩包，右键解压，把解压出来的文件夹名字改成 “solitude”（必须改这个名字，不然用不了）。
  3. 把改好名的 “solitude” 文件夹，复制到你 Hexo 博客的 “themes” 目录里（比如 “我的博客 \themes”）。

方式 3：用包管理器安装（熟悉 npm 的可选）

如果电脑里有 npm、pnpm、yarn 或 bun 中的任意一个，直接在命令行输入对应命令：

  • npm：npm i hexo-theme-solitude
  • pnpm：pnpm i hexo-theme-solitude
  • yarn：yarn add hexo-theme-solitude
  • bun：bun add hexo-theme-solitude
    等待安装完成即可。

2.置主题：让 Hexo 使用 Solitude

  1. 打开你的 Hexo 博客目录，找到名为 “_config.yml” 的文件（这是 Hexo 的全局配置文件，用记事本或记事本 ++ 打开就行）。
  2. 在文件里找 “theme:” 这一行（大概在文件中间位置），把后面的内容改成 “solitude”，比如原来可能是 “theme: landscape”，改成 theme: solitude （注意冒号后面有个空格）。
  3. 保存文件并关闭。
1
theme: anzhiyu

2.1覆盖配置

覆盖配置可以使主题配置放置在 Solitude 目录之外，避免在更新主题时丢失自定义的配置。

  • 如果你是linux系统就执行以下命令
1
2
cp -rf ./themes/Solitude/_config.yml ./_config.Solitude.yml

  • 如果你是win系统执行以下命令
1
2
copy "themes\Solitude\_config.yml" "_config.Solitude.yml"

注意：

  1. 只要存在于 _config.Solitude.yml 的配置都是高优先级，修改原 _config.yml 是无效的。
  2. 每次更新主题可能存在配置变更，请注意更新说明，可能需要手动对 _config.Solitude.yml 同步修改。
  3. 想查看覆盖配置有没有生效，可以通过 hexo g –debug 查看命令行输出。
  4. 如果想将某些配置覆盖为空，注意不要把主键删掉，不然是无法覆盖的

3.安装必要依赖（缺一不可）

  • npm：npm i hexo-renderer-pug
  • pnpm：pnpm i hexo-renderer-pug
  • yarn：yarn add hexo-renderer-pug
  • bun：bun add hexo-renderer-pug
    等待安装完成，没有报错就可以了。

4.本地启动博客，查看效果

1.依次在命令行输入下面三个命令，每个命令输完按回车，等待上一个完成再输下一个：

1
2
3
hexo clean
hexo generate
hexo server
  1. 当命令行出现 “Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.” 时，说明启动成功了。
  2. 打开浏览器，在地址栏输入 “http://localhost:4000”，按回车，就能看到你的博客已经换成 Solitude 主题啦！

5.部署上线（到GitHub与Cloudflare Pages）

1
2
3
4
5
6
//本地预览
hexo cl; hexo s

//推送更新上线
hexo cl; hexo g; hexo d

其实和第四步差不多，就多了个hexo d

注意事项

  1. 复制配置文件时，不要删除主题目录（themes/solitude）里的 “_config.yml” 文件，不然会出错。
  2. 以后升级主题后，要对比一下新主题的 “_config.yml” 和你博客目录的 “_config.solitude.yml”，把新增的配置同步过去。
  3. 如果启动后浏览器打不开，检查一下命令有没有输错，或者端口 4000 被占用（可以换端口，输入 hexo server -p 5000 ，然后访问http://localhost:5000）。