Butterfly主题安装魔改日志文档,升级主题方便找到回家的路!


1.Butterfly主题安装与应用

  1. 通过GitHub安装

    在你的 Hexo 根目录里clone主题仓库:

    git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
  2. 应用主题

    修改 Hexo 根目录下的 _config.yml,把主题改为butterfly:

    theme: butterfly
  3. 安装插件

    如果你没有 pug 以及 stylus 的渲染器,请下载安装:

    npm install hexo-renderer-pug hexo-renderer-stylus --save
  4. 升级建议

    升级完成后,请到 Github 的 Releases 界面 或者 文档七 查看新版的更新内容。

    里面有标注 _config 文件的变更内容(如有),请根据实际情况更新你的配置内容。

    为了减少升级主题后带来的不便,请使用以下方法(建议,可以不做):

    此方法只支持 Hexo 5.0.0 以上版本,建议使用。

    如果已经在 source/data/ 创建了 butterfly.yml,请记得删除掉。

    在 hexo 的根目录创建一个文件 _config.butterfly.yml,并把主题目录的 _config.yml 内容复制到 _config.butterfly.yml 去。

    注意: 不要把主题目录_config.yml 删掉。

    以后只需要在 _config.butterfly.yml进行配置就行。Hexo会自动合并主题中的_config.yml_config.butterfly.yml里的配置,如果存在同名配置,会使用_config.butterfly.yml的配置,其优先度较高。

  5. 主题配置

    请参考butterfly主题官方配置文档:主题配置-1主题配置-2主题问答进阶教程


2.Butterfly主题魔改

2.1博客背景使用一图流

先在配置文件配置背景为图片,再在自定义样式文件设置透明度。

这是效果图

教程文章链接:

2.2版权声明美化

本篇教程是转载Akilarの糖果屋的《(二创)Copyright-beautify》的教程贴,记录博客魔改历程,方便以后升级找到回家的路。

这是效果图

教程文章链接:

2.3自定义样式魔改

本篇教程参考 Akilarの糖果屋的《Custom Beautify》教程贴的基础上进行的二次创作,记录博客魔改历程,方便以后升级找到回家的路。

这是效果图

教程文章链接:

2.4添加外挂标签

本篇教程是转载Akilarの糖果屋的《Tag Plugins Plus》的教程贴,记录博客魔改历程,方便以后升级找到回家的路。

这是效果图

教程文章链接:

2.5页脚电子时钟(原生)

根据糖果屋的教程,并加了一些改动。

这是效果图

教程文章链接:

2.6引入阿里图标库

本篇教程参考 Akilarの糖果屋的《Iconfont Inject》教程贴的基础上进行的二次创作,记录博客魔改历程,方便以后升级找到回家的路。

这是效果图

教程文章链接:

2.7添加首页卡片进入动画

本篇教程参考Akilarの糖果屋的《Add Blog Animation — Wowjs》教程贴,记录博客魔改历程,方便以后升级找到回家的路。

这是效果图

教程文章链接:

2.8添加留言板

此篇文章为了记录博客魔改过程,方便找到回家的路。参考Akilarの糖果屋的《信笺样式留言板》

教程,为了方便以后的升级与自定义,本文只记录插件化魔改和旧版markdown魔改方案,减少像源码魔改方案的侵入性。

这是效果图

教程文章链接:

2.9添加朋友圈

添加友链朋友圈,方便查看朋友动态。

这是效果图

教程文章链接:

2.10添加百宝箱

在日常生活中我们经常需要收藏许多网址书签来提升我们的办公效率,但是书签的放置,整理和分类的工作总是一言难尽,非常麻烦。因此本次将通过建立一个hexo小站来单独存储我们的所有收藏网址,也就是今天要介绍的百宝箱😛!

这个百宝箱的搭建你可以理解为是建立一个新的hexo网站,因此很显然他是基于一个主题搭建的,这个主题就是hexo-theme-webstack

这是效果图

教程文章链接:

2.11添加在线聊天

从3.0开始,butterfly主题内置了多种在线聊天工具。你可以选择开启一种,方便你与访客的交流。

本博客采用的是Gitter在线聊天工具,正好与GitHub组成一套。

这是效果图

教程文章链接:

2.12GitHub Actions 自动部署博客

本文参考Akilarの糖果屋的《使用 Github Action 实现全自动部署》。实现GitHub Actions 自动部署博客,减少编译等待时间,同时可以方便在线修改文章。

教程文章链接:

2.13添加GitHub提交日历

此魔改参考:小冰博客的《教程:hexo-githubcalendar 插件 1.0》Akilarの糖果屋的《Gitcalendar》。本博客使用冰老师的hexo-githubcalendar 插件 1.2.2版本

这是效果图

教程文章链接:

2.14添加看板娘

此魔改参考:Akilarの糖果屋的《Live2d Widget》教程贴中的大神魔改看板娘(会说话,能换装)部分。并通过修改waifu.css文件调整了看板娘布局位置。

这是效果图

教程文章链接:

2.15npm图床搭建

本文参考文章:Akilarの糖果屋的《npm 图床的使用技巧》。记录一下,方便找到回家的路。

教程文章链接: