官方教程上有的就不在赘述了，仔细阅读官方文档能解决绝大部分问题。

评论

在使用评论系统之前需要首先 npm安装相应的插件，然后配置butterfly.yml中关于评论的设置。
如果不想在某个页面开启评论，可以在页面头部使用如下方式

---
title: butterfly修改
date: 2020-07-05 21:11:42
comments: false
---

valine评论添加QQ提醒

butterfly主题把下列js代码修改后添加到butterfly.yml中的inject后面就好了。
其他的需要将下列代码添加到一个位置，使每个有valine评论的页面有下列代码。

要先加Qmsg酱为好友。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
var title2="msg=您的博客又有新评论啦~ \n";
var SCKEY_Qmsg=" ";
function send_valine_Qmsg(){
    var pagename=document.title;
    var wz=pagename.indexOf('|');
    var res=pagename.substring(0,wz);
    var pageurl=document.URL;
    var ptime=new Date();
    var vnick=document.getElementsByClassName("vnick vinput")[0].value;
    var vmail=document.getElementsByClassName("vmail vinput")[0].value;
    var vlink=document.getElementsByClassName("vlink vinput")[0].value;
    var veditor=document.getElementsByClassName("veditor vinput")[0].value;
    var data="昵称："+vnick+"\n邮箱："+vmail+"\n网站地址："+vlink+"\n当前页面："+pagename+"\n评论内容："+veditor+"\n跳转链接："+pageurl+"\n评论时间："+ptime.toLocaleString();
    var httpRequest = new XMLHttpRequest();
    httpRequest.open('POST',SCKEY_Qmsg, true); 
    httpRequest.setRequestHeader("Content-type","application/x-www-form-urlencoded");
    httpRequest.send(title2+data);
};
var ValineButton=document.getElementsByClassName("vsubmit vbtn")[0];
ValineButton.onclick=send_valine_Qmsg;

SCKEY_Qmsg设置为Qmsg酱的接口地址。
转自零奇

图片

Github加载图片速度极慢，选择Gitee上的Gitee Pages作为图床，

在gitee的仓库中上传完图片后，一定要重新更新一下Gitee Pages服务后才能生效。

链接

此版本使用hexo-abbrlink插件生成永久链接时会出现bug，卸载解决。

引入Katex

使用时需要在front-matter里加入： katex: true
具体使用方法见katex。

Subtitle

主页面的subtitle，在设置 source : 3 的 一句 接口时出现了https错误。

Mixed Content: xxx This request has been blocked; the content must be served over HTTPS.

原因是在HTTPS页面中引入了HTTP的资源，解决方案实在页面头部插入

<meta http-equiv="Content-Security-Policy" content="upgrade-insecure-requests">

可以在 butterfly.yml 找到inject:head,在后面加入上述代码即可。

note标签

默認 提示塊標籤

default 提示塊標籤

primary 提示塊標籤

success 提示塊標籤

info 提示塊標籤

warning 提示塊標籤

danger 提示塊標籤

butterfly 更新至 3.4.2 (2020/12/27)

  1. 添加了pjax

  2. 文章页目录改为aside显示

  3. 添加aplayer全局播放器

  4. 添加了豆瓣 电影、书籍、游戏

  5. 添加gitalk，和Qmsg的提示，变成gitalk和valine双评论

  6. aerith位置修改

  7. 添加steam，暂时先用着，作者很长时间没更新了，等之后有时间自己写一个好看点的。。。

  8. 添加老版本3.2，使用时需要将 _config.yml 内

1
theme: butterfly-3.2

\source\_data\.butterfly.yml 改为 butterfly.yml

隐藏 Archives 的sidebar

  1. 修改 \theme\layout\includes\layout.pug 文件
  • 1、2行
1
2
- var htmlClassHideAside = (theme.aside.enable && theme.aside.hide)|| is_archive()==true? 'hide-aside' : ''
- var hideAside = !theme.aside.enable || page.aside === false || is_archive()==true ? 'hide-aside' : ''
  • 26行
1
if theme.aside.enable && page.aside !== false && is_archive()==false