参考文档

以下内容均来自butterfly官方文档

注意事项

安装

建议使用git安装

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

如果通过 npm 安装并不会在 themes 里生成主题文件夹，而是在 node_modules 里生成

  • 安装npm install hexo-theme-butterfly

  • 升级npm update hexo-theme-butterfly

配置文件设置

为了减少升级主题后带来的不便，建议使用以下方法（可以不做）。

在 hexo 的根目录创建一个文件 _config.butterfly.yml，并把主题目录的 _config.yml 内容复制到 _config.butterfly.yml 去。( 注意: 复制的是主题的 config.yml ，而不是 hexo 的 _config.yml)，且不要删除根目录下的config.yml

Hexo会自动合并主题中的 _config.yml 和 _config.butterfly.yml 里的配置，如果存在同名配置，会使用 _config.butterfly.yml 的配置，其优先度较高。

外挂标签

官网做了很多外挂标签的内容，还挺有用的，有时间可以学一下，包括图库、相册、显示、隐藏内容（移动鼠标到隐藏内容上可显示）、绘制图表、图标等等…

官网外挂标签介绍

自定义侧边栏

可以自定义侧边栏内容，自己添加想要展示的内容也可以，例如不显示网站信息、分类、归档等内容，添加自己喜欢的展示信息等都可以实现，有详细的参数说明

自定义侧边栏

配置不生效

有一些配置即使在G:\hexo\_config.butterfly.yml进行修改，但是也不生效，例如

rightside_scroll_percent: true

设置滚动的百分比，但是在文章滚动时还是显示“返回顶部”的↑，并没有显示数字，还有一些其他不生效的，例如隐藏侧边栏的button，设为true也没有显示↔的按钮

1
2
3
4
aside:
  enable: true
  hide: false
  button: true