butterfly-halo-theme/README.md

一个Halo博客主题，Butterfly

<p align="center">Butterfly 主题 Halo 2.0</p>

- `Butterfly` 是Hexo社区[hexo-theme-Butterfly](https://github.com/jerryc127) 此次移植`pug`模板引擎调整为 `thymeleaf`，
  希望大家喜欢 ❤️
- 同时也要在此感谢原作者 [Jerry](https://github.com/jerryc127)
  欢迎大家加入 [halo-theme-Butterfly 交流群：916571927](https://jq.qq.com/?_wv=1027&k=LfbGKBVG)

#### 👀 [预览主题](https://dhjdd.cn)

[comment]: <> (📗 [使用文档]&#40;&#41;)

**效果图** 👇
![效果图](https://fastly.jsdelivr.net/npm/halo-theme-butterfly@latest/docs/renderings.png)

### 🌈 安装

- 主题仓库地址 `https://github.com/dhjddcn/halo-theme-butterfly.git`
- 在 [Release](https://github.com/dhjddcn/halo-theme-butterfly/releases) 页面下载最新版本 `zip`
  后，通过 `Halo Console` 安装上传即可。

![效果图](https://fastly.jsdelivr.net/npm/halo-theme-butterfly@latest/docs/user.png)
![效果图](https://fastly.jsdelivr.net/npm/halo-theme-butterfly@latest/docs/metadata.png)

### ⚠️ 注意

- 安装主题后，需要在 `Halo Console - 主题 - 基本 - metadata.name`
  中进行配置，否则主题无法正常使用。此处配置的名称可以在 `Halo Console - 用户 - 用户详情 - 用户名` 中获取。

### ⭐️ 主题功能

- [x] 二维码打赏
- [x] 预制主题字体
- [x] 自定义背景图
- [x] 页面顶部自定义图
- [x] 文章列表（列表/平铺）
- [x] 侧边栏 全局/单独控制
- [x] 分类/标签页UI优化
- [x] 社交账号配置
- [x] 代码高亮 + 行号 + 复制 + 折叠
- [x] 随机图片api配置
- [x] 统计页面 总访问量
- [x] 站点运行时间
- [x] 主题模式（深色/浅色）

### 📃 TODO

> 目前仍有部分功能不完善，暂时没时间做，后面继续迭代。

- 页面元数据控制
  百度收录查询 + 主动推送
- 全站 Pjax
- 相册页开发
- 多种布局切换
- 页面动画效果优化
- 自定义标签
- 数学公式
- 局部优化
  <br>

#### 如何自定义导航条菜单图标？

> 主题本次移植使用的是 `fontawesome` 字体图标，你可以在 [fontawesome](https://fontawesome.com/search)
> 上找到你想要的图标，然后复制图标的 `class` 名称，如下所示：
> 如我站点首页图标为 `fa-home fa-solid fa-bolt-auto` ，则在 `菜单-图标` 填入 `fa-home fa-solid fa-bolt-auto` 即可<br>