butterfly 主题配置
安装
在 Hexo 根目录里
1 | git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly |
应用主题
修改 Hexo 根目录下的 ,把主题改为 _config.ymlbutterfly
1 | theme: butterfly |
安装插件
如果没有 pug 以及 stylus 的渲染器,下载安装:
1 | npm install hexo-renderer-pug hexo-renderer-stylus --save |
主题配置
主题配置文件
是themes/butterfly/_config.yml
导航目录
设置顶部右上方区域的内容
1 | # Menu 目录 |
这里的目录中,tags
、categories
、link
、about
目录默认不存在,需要在Bash窗口中使用命令生成对应页面
1 | hexo new page tags |
把创建的页面设置为对应的页面类型
代码高度限制
可配置代码高度限制,超出的部分会隐藏,并显示展开按钮。
1 | highlight_height_limit: false # unit: px |
注意:
单位是px
,直接添加数字,如 200
实际限制高度为highlight_height_limit + 30 px
,多增加 30px 限制,目的是避免代码高度只超出highlight_height_limit 一点时,出现展开按钮,展开没内容。
不适用于隐藏后的代码块( css 设置display: none
)
页脚自定义文本
custom_text
是一个用来在页脚自定义文本的选项。通常可以在这里写声明文本等。支持 HTML。
修改主题配置文件_config.butterfly.yml
。
页脚如下,若在配置时没有出现github徽章,请参考教程添加Github徽标
.
1 | custom_text: I wish you to become your own sun, no need to rely on who's light.<p><a target="_blank" href="https://hexo.io/"><img src="https://img.shields.io/badge/Frame-Hexo-blue?style=flat&logo=hexo" title="博客框架为Hexo"></a> <a target="_blank" href="https://butterfly.js.org/"><img src="https://img.shields.io/badge/Theme-Butterfly-6513df?style=flat&logo=bitdefender" title="主题采用butterfly"></a> <a target="_blank" href="https://www.jsdelivr.com/"><img src="https://img.shields.io/badge/CDN-jsDelivr-orange?style=flat&logo=jsDelivr" title="本站使用JsDelivr为静态资源提供CDN加速"></a> <a target="_blank" href="https://vercel.com/ "><img src="https://img.shields.io/badge/Hosted-Vervel-brightgreen?style=flat&logo=Vercel" title="本站采用双线部署,默认线路托管于Vercel"></a> <a target="_blank" href="https://vercel.com/ "><img src="https://img.shields.io/badge/Hosted-Coding-0cedbe?style=flat&logo=Codio" title="本站采用双线部署,联通线路托管于Coding"></a> <a target="_blank" href="https://github.com/"><img src="https://img.shields.io/badge/Source-Github-d021d6?style=flat&logo=GitHub" title="本站项目由Gtihub托管"></a> <a target="_blank" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img src="https://img.shields.io/badge/Copyright-BY--NC--SA%204.0-d42328?style=flat&logo=Claris" title="本站采用知识共享署名-非商业性使用-相同方式共享4.0国际许可协议进行许可"></a></p> |
对于部分人需要写 ICP 的,也可以写在custom_text
里。
1 | custom_text: <a href="icp链接"><img class="icp-icon" src="icp图片"><span>备案号:xxxxxx</span></a> |
打字效果
修改主题配置文件_config.butterfly.yml
1 | # Typewriter Effect (打字效果) |
页面加载动画preloader
当进入网页时,因为加载速度的问题,可能会导致top_img图片出现断层显示,或者网页加载不全而出现等待时间,开启preloader后,会显示加载动画,等页面加载完,加载动画会消失。
1 | # 加载动画 Loading Animation |
启用本地搜索
1 | search: |
文章 meta 显示
post_meta
这个属性用于显示文章的相关信息的。
修改主题配置文件_config.butterfly.yml
.
1 | post_meta: |
文章版权和协议许可
修改主题配置文件_config.butterfly.yml
。
1 | post_copyright: |
由于 Hexo 4.1
开始,默认对网址进行解码,以至于如果是中文网址,会被解码,可设置 decode: true
来显示中文网址。
如果有文章(例如:转载文章)不需要显示版权,可以在文章页 Front-matter
中单独设置。
1 | copyright: false |
文章打赏
修改主题配置文件_config.butterfly.yml
。
1 | reward: |
阅读模式
阅读模式下会去掉除文章外的内容,避免干扰阅读。只会出现在文章页面,右下角会有阅读模式按钮。
修改主题配置文件_config.butterfly.yml
。
1 | readmode: true |
池塘养鱼
在主题配置文件 _config.butterfly.yml
加入以下代码:
1 | inject: |
有时候会遇到cdn解析失败,导致鱼塘加载不出来,可以js文件格式本地引入
在 source 目录下新建一个 styles 文件夹,用于存放相关文件
添加如下两个文件
文件一:fish-base.js
1 | var RENDERER = { |
文件二:fish.js
1 | fish(); |
在主题配置文件下引入这两个文件
代码如下:
1 | - <script src="/styles/fish.js"></script> |
一样也得引入 jquery:
1 | - <script src="https://cdn.bootcss.com/jquery/3.4.1/jquery.min.js"></script> |
渐变色设置
在styles目录下新建一个 main.css 文件,键入以下代码:
1 | /* 鱼塘固定宽度 */ |
这里只修改了鱼塘和部分个人主页的渐变色,也可以自己调成你喜欢的渐变色
同样,也需要在主题配置文件中引入这个css文件:
1 | - <link rel="stylesheet" href="/styles/main.css"> |