Hexo有非常丰富的主题可供选择：官方主题页。
这边选择了一个个人比较喜欢的主题：Butterfly。

0.版本

基于以下环境:

  • hexo: 6.3.0
  • hexo-cli: 4.3.1
  • node: v18.16.0
  • butterfly: 4.9.0

1. 安装主题

安装主题主要有两种方式：npm安装和git安装。(butterfly主题在hexo版本>=5.0.0时才支持npm安装)

由于实践下来git的安装方式进行github pages部署时会出现一些问题，所以这边选择npm安装。

※ git安装时把主题作为submodule进行管理，但是部署时却会出现jekyll找不到主题的错误。

1.1 下载主题

在Hexo项目根目录下执行：

  • npm 安装
    1
    npm i hexo-theme-butterfly
  • (或者) git 安装
    1
    git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

1.2 安装依赖

该主题需要安装pug 以及 stylus 的渲染器，
在Hexo项目根目录下执行：

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

1.2 应用主题

修改Hexo项目根目录下的_config.yml文件，将theme修改为：

1
theme: butterfly

2. 配置主题

主题的配置文件在themes/butterfly/_config.yml中。(此文件请勿删除)

由于git拉取代码的升级方式会覆盖该配置文件，为了不影响升级，可以将配置项复制到Hexo项目根目录下的_config.butterfly.yml中。

Hexo会自动合并根目录下的_config.butterfly.yml和主题目录下的_config.yml，所以可以只在根目录下的_config.butterfly.yml中修改配置项即可。(同一配置项，根目录下的优先级高于主题目录下的)

2.1 具体配置项

具体配置项请参考：Butterfly 安裝文檔(三) 主題配置-1

3.Github Pages部署配置(若非部署到GitHub pages的话不用操作)

在Hexo项目根目录下创建一个名为”.nojekyll”的文件，
用来防止github pages把项目当成jekyll来处理。

结束

至此，Hexo的主题安装和配置就完成了。