Hexo + Butterfly 主题美化指南 🎨
✨ 特别说明
欢迎访问本站!本博客基于 Hexo 静态框架 + Butterfly 主题构建,兼具简洁美观与强大功能。
📌 本站内容仅供学习交流,不承担因版本差异导致的问题。已适配版本:
- Hexo
7.3.0
- Butterfly
5.3.5
📑 导航目录
- 🎯 一、页脚渐变色效果
- ⬇️ 二、直达底部按钮
- ✨ 三、动画特效增强
- 🔖 四、标题图标美化
- 🎵 五、全局吸底播放器
- 🌊 六、文章顶部波浪效果
- 📝 七、文章标题居中
- 🧲 八、首页分类磁贴
- 🌙 九、夜间模式动画
- 🎨 十、导航栏多彩图标
- 💫 十一、黑夜霓虹灯效果
- 🔲 十二、全局圆角设计
- 🎭 十三、页面美化优化
- 🚀 十四、CDN加速配置
- 😺 十五、挂绳小猫咪特效
- 🛡️ 十六、禁用F12保护
- 👁️ 十七、写轮眼加载动画
- ⏰ 十八、页脚徽标和计时器
- 🖼️ 十九、一图流背景设计
- 🔤 二十、引用字体美化
- 🎚️ 二十一、滚动条样式美化
- 💡 二十二、头像呼吸灯效果
- 🖼️ 二十三、博客背景切换
- 👋 二十四、访客定位欢迎信息
- 🐾 二十五、脚页添加小动物
- 📜 二十六、今日诗词侧边栏
- 📋 二十七、复制弹窗提醒
- 📖 二十八 、留言板 Violet 风格
- 📖 二十九 、文章置顶轮播图
🎯 一、页脚渐变色效果
✨ 功能特点
- 为博客页脚添加动态渐变色彩效果,色彩平滑过渡,提升视觉体验。支持多色渐变循环动画,让页脚区域变得生动有趣。
🔧 实现步骤
- 1. 🧩 创建CSS文件:
- 创建
Hexo根目录/source/css/页脚渐变.css
文件,将下面代码复制粘贴到该文件中。
- 创建
|
|
- 2. ➕ 引入CSS文件:
- 在
_config.butterfly.yml
文件中找到inject
部分,如果该部分不存在,添加以下内容
- 在
|
|
3. 🚀 清理并重启项目:
|
|
⬇️ 二、直达底部按钮
✨ 功能特点
- 添加一键滚动至页面底部的便捷按钮,提升用户体验,特别适合长文章页面。
🔧 实现方法
- 在
Hexo根目录\themes\butterfly\layout\includes\rightside.pug
最后添加以下内容
|
|
✨ 三、动画特效增强
✨ 功能特点
- 使用
WOW.js
为页面元素添加丰富的入场动画效果,让页面加载和滚动时呈现流畅的动画体验。
🔧 安装配置
|
|
- 在站点配置文件
_config.yml
或者主题配置文件_config.butterfly.yml
中添加: - 动画预览网站: https://animate.style/
⚙️ 配置示例
|
|
🚀 清理并重启项目:
|
|
🔖 四、标题图标美化
✨ 功能特点
为文章标题添加旋转风车图标,增强视觉吸引力,支持悬停特效和响应式设计。
🎨 特色功能
- 🌀 动态旋转风车图标
- 🎯 多级标题不同颜色
- 📱 移动端适配优化
- ✨ 悬停放大效果
🎨 修改主题配置
- 文件
_config.butterfly.yml
文件的beautify
配置项
|
|
- 创建
Hexo根目录/source/css/custom-icon.css
文件,将代码复制粘贴到该文件中。 - 【 fontawesome 的 icon 图标代号 】
🧩 创建CSS文件:
|
|
➕ 引入CSS文件:
- 在
_config.butterfly.yml
文件中找到inject
部分,添加以下内容:
|
|
🚀 清理并重启项目:
|
|
🎵 五、全局吸底播放器
✨ 功能特点
添加全局音乐播放器,支持歌单管理、歌词显示、美观的播放控制界面。
🔧 安装插件
|
|
⚙️ _config.yml
配置示例
|
|
⚙️ _config.butterfly.yml
配置示例
|
|
🎵 aplayer 的 html 配置文件
- 在
Hexo根目录\themes\butterfly\layout\includes\head.pug
后追加内容
|
|
- 说明
|
|
🎵 aplyer 音乐播放器美化
- 添加代码到
aplayer.css
文件 - 创建
Hexo根目录/source/css/aplayer.css
文件,将代码复制粘贴到该文件中。
|
|
➕ 引入样式文件:
- 在
_config.butterfly.yml
文件中找到inject
部分,添加以下内容:
|
|
默认隐藏歌词
- 添加代码到
隐藏歌词.js
文件 - 创建
Hexo根目录/source/js/隐藏歌词.js
文件,将代码复制粘贴到该文件中。
|
|
➕ 引入 隐藏歌词.js
文件
- 在
_config.butterfly.yml
文件中找到inject
部分,如果该部分不存在,添加以下内容:
|
|
🚀 清理并重启项目:
|
|
🌊 六、文章顶部波浪效果
✨ 功能特点
在文章顶部添加动态波浪效果,增强视觉层次感,提升页面动态美感。
🔧 实现步骤
1. ✍️ 修改模板文件:
- 修改
Hexo根目录/themes/butterfly/layout/includes/header/index.pug
大概第33
行左右
|
|
为了方便复制,提供一份需要修改的部分:
|
|
2. ➕ 创建波浪CSS:
创建 Hexo根目录/source/css/bolang.css
文件,将代码复制粘贴到该文件中
|
|
3. ➕ 引入CSS文件:
- 在
_config.butterfly.yml
文件中找到inject
部分,添加以下内容:
|
|
🚀 清理并重启项目:
|
|
📝 七、文章标题居中
✨ 功能特点
将文章标题及其相关信息居中显示,提升页面排版美观度。
🔧 实现方法
- 博客根目录
\themes\butterfly\source\css_layout\head.styl
- 该代码块在第100行左右
|
|
🧲 八、首页分类磁贴
✨ 功能特点
使用磁贴式布局展示分类标签,支持自定义图标和悬停效果,增强首页视觉吸引力。
🔧 安装插件
|
|
- 卸载插件
- 注意,一定要加
--save
,不然本地预览的时候可能不会显示!!!
- 注意,一定要加
|
|
⚙️ 配置示例
- 在网站配置文件
_config.yml
新增以下项 (注意不是主题配置文件
),这里的分类名字必须和你文章的分类名字一一对应:
|
|
配置项说明
- 配置项的含义:
- enable
- 参数:true/false
- 含义:是否开启插件
- enable_page
- 参数:/
- 含义:路由地址,如 / 代表主页。/me/ 代表自我介绍页等等
- priority
- 参数:1
- 含义:插件的叠放顺序,数字越大,叠放约靠前。
- type
- 参数:categories/tags
- 含义:选择筛选分类还是标签
- devide
- 参数:2
- 含义:表示分隔的列数,2 表示分为两列展示
- display
- 参数:
|
|
- 含义:配置项,可自行设置,按照设置的顺序展示
- color_setting
- 参数:
|
|
- 含义:颜色配置项,可自行设置
- layout
- 参数:type; (class&id)
- 参数:name;
- 参数:index;(数字)
- 含义:如果说 magnet 是一幅画,那么这个 layout 就是指定了哪面墙来挂画 而在 HTML 的是世界里有两种墙分别 type 为 id 和 class。 其中在定义 class 的时候会出现多个 class 的情况,这时就需要使用 index,确定是哪一个。 最后墙的名字即是 name;
|
|
参数:html 模板字段
含义:包含挂载容器
|
|
- plus_style
- 参数:“” 含义:提供可自定义的 style,如加入黑夜模式。
🚀 清理并重启项目:
|
|
修复黑夜模式
我们可以看到黑夜模式看起来特别的别扭,因此还要做一下黑夜模式的颜色适配,在custom.css
文件中添加以下代码适配黑夜模式(具体颜色可以自己调节):
|
|
🌙 九、夜间模式动画
✨ 功能特点
为明暗模式切换添加平滑过渡动画,提升用户体验,增强界面交互感。
🔧 实现步骤
1. ➕ 创建 svg 文件
- 新建
博客根目录\themes\butterfly\layout\includes\custom\sun_moon.pug
,这部分其实实质上就是一个svg文件,通过js操作它的旋转显隐,淡入淡出实现动画效果。
|
|
2. ➕ 创建 styl
动画文件
|
|
3. ➕创建JS文件
- 新建
博客根目录\themes\butterfly\source\js\sun_moon.js
,去除了冗余代码,去jquery
|
|
4. ➕ 引入动画文件:
|
|
5. ✍️ 修改相关文件
- 修改
博客根目录\themes\butterfly\layout\includes\head.pug
,在文件末位加上一行
|
|
修改博客根目录\themes\butterfly\layout\includes\rightside.pug
,把原本的昼夜切换按钮替换掉
|
|
6. 🚀 清理并重启项目:
|
|
🎨 十、导航栏多彩图标
✨ 功能特点
使用阿里巴巴矢量图标库为导航栏添加多彩图标,支持动态效果和自定义样式。
🔧 实现步骤
1. ➕ 引入iconfont图标
新建图标项目
-
访问 阿里巴巴矢量图标库 ,注册登录。
-
搜索自己心仪的图标,然后选择添加入库,加到购物车。
-
选择完毕后点击右上角的购物车图标,打开侧栏,选择添加到项目,如果没有项目就新建一个。
-
可以通过上方顶栏菜单->资源管理->我的项目,找到之前添加的图标项目。(现在的iconfont可以在图标库的项目设置里直接打开彩色设置,然后采用fontclass的引用方式即可使用多彩图标。但是单一项目彩色图标上限是40个图标,酌情采用。)
引入图标
线上引入方案,我使用的是官方文档中最便捷的font-class
方案。这一方案偶尔会出现图标加载不出的情况。但是便于随时对图标库进行升级,换一下在线链接即可,适合新手使用。最新版本的iconfont支持直接在项目设置中开启彩色图标,从而实现直接用class添加多彩色图标。(推荐直接用这个即可)
- 在
[BlogRoot]\themes\butterfly\source\css\custom.css
中填写如下内容,引入Unicode和Font-class的线上资源:
|
|
更推荐在在主题配置文件inject
配置项进行全局引入:
|
|
同时可以在自定义CSS
中添加如下样式来控制图标默认大小和颜色等属性(若已经在项目设置中勾选了彩色选项,则无需再定义图标颜色),写法与字体样式类似,这恐怕也是它被称为iconfont
(图标字体)的原因:
|
|
可以通过自己的阿里图标库的font-class方案查询复制相应的icon-xxxx
。
|
|
2. 🎨 菜单栏多色动态图标
详见: 糖果屋微调合集
相比于静态的图标,个人更喜欢动态的,因此一步到位!
前置教程:
Hexo引入阿里矢量图标库-iconfont inject
和
基于Butterfly的外挂标签引入-Tag Plugins Plus
中关于动态标签anima
的内容。请确保您已经完成了前置教程,并实现了在文章中使用symbol
写法来引入iconfont
图标。同时引入了fontawesome_animation
的前置依赖。
主要检查您的inject
配置项中是否有这两个依赖
|
|
替换[BlogRoot]\themes\butterfly\layout\includes\header\menu_item.pug
为以下代码,本方案默认使用观感最佳的悬停父元素触发子元素动画效果,默认动画为faa-tada
。注意:可以把之前的代码注释掉,再在后面加上如下代码,以便于回滚,此代码在butterfly 4.3.1
上可以运行并保留hide字段隐藏子菜单的功能,其他版本自行测试。代码的本质并不复杂,就是扫描配置文件对应的配置项,然后根据||
的分割标志筛选出对应的图标名称、对应链接等,从而渲染出html页面。
|
|
以下是填写示例,在[BlogRoot]\_config.butterfly.yml
中修改。icon-xxx
字样的为iconfont
的symbol
引入方案的id
值,可以在你的iconfont
图标库内查询,其中hide属性也是可以用的。
|
|
要注意的是,这里的动态图标是svg.icon
的标签,因此上面调节.iconfont
的css并不使用,我们需要在自定义样式文件custom.css
里加上一些样式来限制图标的大小和颜色等,具体大小自行调节。
|
|
3. ➕ 添加按钮
修改"博客根目录\themes\butterfly\layout\includes\header\nav.pug"
1. 修改搜索按钮图标:
- 图标
icon-a-044_sousuo
修改为自己的,width: 2.2em; height: 2.2em;
修改大小 - 把以下语句删除或注释掉即可,搜索两个字就不会显示出来(这种语句统一写法是直接删除
+
就可以,不用补空格)。
2. 引入明暗模式切换图标:
- 太阳图标:``icon-sun
,月亮图标:
icon-moon。我的默认是黑暗模式,选择太阳图标
use#modeicon(xlink:href=’#icon-shezhi’)`
3. 修改菜单按钮图标:
- 图标
icon-shezhi
修改为自己的,width: 1.6em; height: 1.6em;
修改大小
|
|
完整的 #menus部分
代码
|
|
4. 🚀 清理并重启项目:
|
|
导航栏引入图标
- 修改
"博客根目录\themes\butterfly\layout\includes\header\nav.pug"
|
|
1. 基本结构
|
|
- 这是一个
<a>
链接元素,包含一个嵌套的<svg>
图标。 - 使用了 Pug 的嵌套语法,通过缩进表示层级关系。
2. 链接属性
|
|
- 类名:
.site-page
:基础样式类(可能定义链接的外观)。.faa-parent
:Font Awesome Animation 的父容器类(用于子元素动画)。.animated-hover
:自定义悬停动画效果的类。
- 事件:
onclick='toggleWinbox()'
:点击时调用 JavaScript 函数toggleWinbox()
(可能是控制弹窗/壁纸切换的逻辑)。
- 提示文本:
title='切换壁纸'
:鼠标悬停时显示的工具提示(“切换壁纸”)。
3. SVG 图标
|
|
-
类名:
.faa-tada
:Font Awesome Animation 的“抖动”动画效果。.bizhi
:自定义类(可能用于样式覆盖,bizhi
是中文“壁纸”的拼音)。
-
无障碍:
aria-hidden="true"
:对屏幕阅读器隐藏(因图标仅为装饰)。
-
尺寸:
style="height:2em;width:2em"
:强制宽高为2em
(继承父元素字体大小)。
4. 生成的实际 HTML
|
|
5. 关键功能
- 点击事件: 点击后会触发
toggleWinbox()
(可能是切换壁纸弹窗或壁纸本身的函数)。 - 动画效果:
faa-parent
+faa-tada
组合会让 SVG 图标持续抖动(类似 Font Awesome 的动画效果)。animated-hover
可能添加了悬停时的过渡效果(如颜色变化)。
- 国际化:
title="切换壁纸"
提示中文用户,但代码本身是语言无关的。
6. 可能的依赖库
- Font Awesome Animation:提供
faa-*
动画类。 - Winbox.js:如果
toggleWinbox()
是控制弹窗,可能用到此库。 - 自定义 CSS:
.site-page
、.bizhi
等类需要额外样式文件支持。
完整添加代码
|
|
💫 十一、黑夜霓虹灯效果
✨ 功能特点
为网站标题和副标题添加霓虹灯效果,在黑暗模式下特别醒目,增强视觉冲击力。
🔧 实现方法
1. ➕ 创建霓虹灯效果CSS:
- 详见: 黑夜霓虹灯2.0(纯CSS实现)
- 创建
Hexo根目录/source/css/custom.css
文件,将代码复制粘贴到该文件中
|
|
2. ➕ 引入 custom.css
文件
- 在
_config.butterfly.yml
文件中找到inject
部分,如果该部分不存在,添加以下内容:
|
|
3. 🚀 清理并重启项目:
|
|
🔲 十二、全局圆角设计
✨ 功能特点
为页面元素统一添加圆角设计,营造柔和现代的视觉风格,提升整体美观度。
🔧 实现方法
- 创建
Hexo根目录/source/css/全局圆角.css
文件,将代码复制粘贴到该文件中。
|
|
- ➕ 引入CSS文件:
- 在
_config.butterfly.yml
文件中找到inject
部分,添加以下内容:
- 在
|
|
🚀 清理并重启项目:
|
|
🎭 十三、页面美化优化
✨ 功能特点
全面优化页面样式,包括背景透明度、边框装饰、磨砂效果等,打造精致界面。
🔧 实现方法
- 创建页面美化CSS:
--trans-light
:白天模式带透明度的背景色,如rgba(255, 255, 255, 0.88)
底色是纯白色,其中0.88就透明度,在0-1之间调节,值越大越不透明;--trans-dark
: 夜间模式带透明度的背景色,如rgba(25, 25, 25, 0.88)
底色是柔和黑色,其中0.88就透明度,在0-1之间调节,值越大越不透明;--border-style
: 边框样式,1px solid rgb(169, 169, 169)
指宽度为1px的灰色实体边框;--backdrop-filter
: 背景过滤器,如blur(5px) saturate(150%)
表示饱和度为150%的、高斯模糊半径为5px的过滤器,这是亚克力效果的一种实现方法;- 大家可以根据自己喜好进行调节,不用拘泥于我的样式!
创建 Hexo根目录/source/css/页面美化.css
文件,将代码复制粘贴到该文件中。
|
|
- 📌 常驻导航栏
- 在
_config.butterfly.yml
文件中修改为:
- 在
|
|
🚀 清理并重启项目:
|
|
🚀 十四、CDN加速配置
✨ 功能特点
通过CDN加速静态资源加载,提升网站访问速度,优化用户体验。
🔧 配置方法
修改主题配置文件中的CDN设置:
- 主题默认的CDN有:local、cdnjs、jsdelivr、unpkg等,但是速度偶读比较一般,要想提高部分标准静态资源的响应速度,走CDN是最好的办法,最好是在国内的CDN。
参考教程:
修改教程,我分享一下我目前在用的方案:
修改主题配置文件_config.butterfly.yml
的CDN
配置项:
|
|
修改完成后可以 f12
->源代码
->网页
看看是否已经加载到对应的资源
😺 十五、挂绳小猫咪特效
✨ 功能特点
添加可爱的小猫咪挂绳特效,随页面滚动而动,增加网站趣味性。
🔧 实现步骤
1. ➕ 添加HTML结构
- 制作一个盛放内容的盒子,在
[BlogRoot]/node_modules/hexo-theme-butterfly/layout/includes/head.pug
(如果是git clone
安装在[BlogRoot]/themes/butterfly/layout/includes/head.pug
)最后一行加入如下代码:
|
|
2. ➕ 创建JavaScript逻辑
- 其实随便放在哪里都行,只要能加载出来就行
- 在
[BlogRoot]/node_modules/hexo-theme-butterfly/source/js
文件夹下新建一个cat.js
,将以下代码复制到文件中。
|
|
3. ➕ 添加样式设计
- 在
[BlogRoot]/node_modules/hexo-theme-butterfly/source/css
文件夹下新建一个cat.css
,将以下代码复制到文件中。当然你也可以选择不新建 css 文件,复制代码到custom.css
也行,总之有地方引入就行。
|
|
在主题配置文件_config.butterfly.yml
中引入cat.js
和cat.css
,当然还有在bottom的最前面引入jQuery
,因为cat.js
的语法依赖jQuery
。
|
|
4. 🚀 清理并重启项目:
|
|
🛡️ 十六、禁用F12保护
✨ 功能特点
添加简单的保护措施,防止用户通过F12查看源码,增强内容安全性。
🔧 实现方法
添加保护代码到模板文件:
- 修改
[BlogRoot]/node_modules/hexo-theme-butterfly/layout/includes/layout.pug
,根据图中位置添加以下 pug 代码(跟head
、body
同级)
|
|
- 将以下代码复制到自定义的
f12.js
,随后在主题配置文件的inject
->bottom
中引入该js文件
|
|
🚀 清理并重启项目:
|
|
**注意:**如果自己调试阶段,可注释第一步和第二步中的代码,再进行编译,就可以打开控制台了。部署时放开注释,编译好再丢上去就OK了
👁️ 十七、写轮眼加载动画
✨ 功能特点
使用写轮眼动画作为页面加载指示器,替代默认加载动画,增加个性化元素。
🔧 实现步骤
1. ➕ 创建加载动画组件
- 创建
博客根目录\themes\butterfly\layout\includes\custom\sharingan.pug
|
|
2. ➕ 引用 sharingan.pug
- 修改
博客根目录\themes\butterfly\layout\includes\head.pug
|
|
3. 💫 配置加载动画替换
- 修改
_config.butterfly.yml
|
|
4. 🚀 清理并重启项目:
|
|
⏰ 十八、页脚徽标和计时器
✨ 功能特点
在页脚添加网站信息徽标和运行时间计时器,展示技术栈和网站运行状态。
🔧 安装插件
|
|
⚙️ 配置示例
- 在主题配置文件
_config.butterfly.yml
中添加配置项
|
|
创建 博客根目录/source/js/runtime.js
|
|
创建 博客根目录/source/css/runtime.css
|
|
🚀 清理并重启项目:
|
|
🖼️ 十九、一图流背景设计
✨ 功能特点
使用单张图片作为全局背景,实现简约而不简单的视觉效果。
🔧 实现方法
- 创建背景样式CSS:
- 创建
Hexo根目录/source/css/custom.css
文件,将代码复制粘贴到该文件中。
- 创建
|
|
- 在主题配置文件
[BlogRoot]\_config.butterfly.yml
文件中的inject配置项的head子项加入以下代码,代表引入刚刚创建的custom.css文件
|
|
- 在主题配置文件
[BlogRoot]\_config.butterfly.yml
文件中的index_img
和footer_bg
配置项取消头图与页脚图的加载项避免冗余加载
|
|
- 在主题配置文件
[BlogRoot]\_config.butterfly.yml
文件中的background配置项设置背景图
|
|
🔤 二十、引用字体美化
✨ 功能特点
使用自定义字体替换系统默认字体,提升排版美观度和品牌一致性。
🔧 实现步骤
1. 🔍 准备字体文件
-
TTF 到 WOFF2转换器: https://products.groupdocs.app/zh/conversion/ttf-to-woff2
-
首先将文件放到CSS同级目录下:
Hexo根目录/source/css/GenJyuuGothic-Medium-2.ttf
- 创建
Hexo根目录/source/css/引用字体.css
文件,将代码复制粘贴到该文件中。
- 创建
|
|
➕ 引入 引用字体.css
文件
- 在 _config.butterfly.yml 文件中找到 inject 部分,如果该部分不存在,添加以下内容:
|
|
配置字体 在 _config.butterfly.yml 文件中修改一下内容:
|
|
🚀 清理并重启项目:
|
|
🎚️ 二十一、滚动条样式美化
✨ 功能特点
自定义浏览器滚动条样式,使其与网站设计风格保持一致,提升细节体验。
🔧 实现方法
- 创建
Hexo根目录/source/css/滚动条样式.css
文件,将代码复制粘贴到该文件中。
|
|
➕ 引入 滚动条样式.css
文件
在 _config.butterfly.yml 文件中找到 inject 部分,如果该部分不存在,添加以下内容:
|
|
🚀 清理并重启项目:
|
|
💡 二十二、头像呼吸灯效果
✨ 功能特点
为头像添加呼吸灯效果,明暗交替闪烁,吸引视觉注意力。
🔧 实现方法
- 创建呼吸灯效果CSS:
- 创建
Hexo根目录/source/css/头像呼吸灯.css
文件,将代码复制粘贴到该文件中。
- 创建
|
|
➕ 引入 头像呼吸灯.css
文件
在 _config.butterfly.yml 文件中找到 inject 部分,如果该部分不存在,添加以下内容:
|
|
🚀 清理并重启项目:
|
|
🖼️ 二十三、博客背景切换
✨ 功能特点
添加背景切换功能,允许用户自定义博客背景图片或颜色,增强个性化体验。
🔧 实现步骤
1. ➕创建切换按钮
自行选择在哪里添加,只需要调用
toggleWinbox
函数就可以
- 引入到右下角方法
修改博客根目录\butterfly\layout\includes\rightside.pug
在众多when下面新增:
|
|
然后修改:
|
|
以上是引入到
右下角
的方法
- 引入到导航栏
右上角
方法
- 图标
#icon-a-zhaopiantupianxiangce
修改为自己的
|
|
2. ➕ 创建 博客根目录/source/js/xxx.js
|
|
3. ➕创建 博客根目录/source/css/xxx.css
|
|
4. ➕ 引入 xxx.js和xxx.css
|
|
5. 🚀 清理并重启项目:
|
|
👋 二十四、访客定位欢迎信息
✨ 功能特点
根据访客IP地址显示定位信息和个性化欢迎语,增强用户参与感。
🔧 实现步骤
1. ➕ 创建欢迎脚本:
作者博客: https://blog.qjqq.cn/posts/2a52.html
新建[BlogRoot]/source/js/welcome.js
文件
奶思猫key申请: https://api.nsmao.net 查看个人经纬度: https://github.com/fomalhaut1998/hexo-theme-Fomalhaut
|
|
2. ➕创建 welcome.css
文件
- 新建
[BlogRoot]/source/css/welcome.css
文件
|
|
3. ➕ 引入 xxx.js和xxx.css
|
|
4. 🚀 清理并重启项目:
|
|
🐾 二十五、脚页添加小动物
✨ 功能特点
在页脚区域添加可爱的小动物装饰,增加网站趣味性和亲和力。
🔧 实现步骤
1. ✍️ 修改页脚模板:
作者博客: https://blog.qjqq.cn/posts/f69c.html
修改[BlogRoot]/themes/solitude/layout/includes/footer.pug
文件,新增以下代码(我是在末尾添加的)
|
|
- 新建
[BlogRoot]/source/css/welcome.css
文件
|
|
2. ➕引入 welcome.css
|
|
3. 🚀 清理并重启项目:
|
|
📜 二十六、今日诗词侧边栏
✨ 功能特点
在侧边栏显示随机古诗词,每日更新,增添文化气息,提升博客品味。
🔧 实现步骤
1. ➕ 创建诗词组件:
张洪Heo: https://blog.zhheo.com/p/2ed9d8dd.html 今日诗词API: https://www.jinrishici.com/
创建组件
主题新建[BlogRoot]/themes/butterfly/layout/includes/widget/card_poem.pug
内容如下:
|
|
2. 🔨 配置侧边栏布局
- 引入组件
- 在
[BlogRoot]/themes/butterfly/layout/includes/widget/index.pug
中你需要的位置添加以下内容:
- 在
|
|
- 填写示例,可以在俩个
|
|
- 创建
Hexo根目录/source/css/custom.css
文件,将代码复制粘贴到该文件中。
|
|
2. ➕引入 custom.css
- 在
_config.butterfly.yml
文件中找到inject
部分,添加以下内容:
|
|
3. 🚀 清理并重启项目:
|
|
📋二十七、复制弹窗提醒
- 修改
_config.butterfly.yml
|
|
✨ 二十八、留言板 Violet 风格
hexo-butterfly-envelope
是一款专为 Butterfly 主题设计的留言板插件。它以其独特的信封抽拉动画和优雅的紫罗兰(Violet)风格设计而备受青睐。
1.📦 安装插件
在博客根目录下运行以下命令来安装插件:
|
|
2. ⚙️ 配置菜单
在主题配置文件 _config.butterfly.yml
中,为 menu
项添加【留言板】条目,并指定其图标。
|
|
3. 🔧 配置详解
以下所有配置均需添加到主题配置文件 _config.butterfly.yml
中。
|
|
4. 🌐 CDN 配置推荐
为了加速图片加载,建议使用 CDN 服务。以下是三种推荐的配置方案。
🚀 jsDelivr CDN
jsDelivr 是一个免费的公共 CDN,速度快且稳定,非常适合开源项目。(推荐使用)
|
|
🦄 Vercel CDN
如果您希望使用自己的图床,可以将图片部署到 Vercel 等平台,获得更自主的控制权。
|
|
🏢 官方 CDN
插件也提供了由 npm 分发的官方图片链接,作为备选方案。
|
|
二十九 、📖 文章置顶轮播图
🚀 提示:本插件基于Butterfly主题深度定制,安装后无需额外样式调整即可完美融入您的博客设计。 🔗 插件作者:Akilar
🌐 来源: https://akilar.top/posts/8e1264d1/
📦 安装步骤
在博客根目录[Blogroot]
下打开终端,运行以下安装指令:
|
|
⚙️ 配置说明
在站点配置文件_config.yml
或者主题配置文件_config.butterfly.yml
中添加以下配置段:
|
|
🔧 参数详解
参数 | 备选值/类型 | 释义 |
---|---|---|
priority |
number | 【可选】过滤器优先级,数值越小,执行越早,默认为10 |
enable |
true/false | 【必选】功能控制开关 |
enable_page |
path/all | 【可选】填写想要应用的页面的相对路径(即路由地址)。如根目录填’/’,分类页面填’/categories/’。填’all’应用于所有页面 |
timemode |
date/updated | 【可选】时间显示模式,date为创建日期,updated为更新日期 |
layout.type |
id/class | 【可选】挂载容器类型,填写id或class,默认为id |
layout.name |
text | 【必选】挂载容器名称 |
layout.index |
0和正整数 | 【可选】当layout.type为class时使用,指定同级class中的顺位 |
default_descr |
text | 【可选】默认文章描述文本 |
swiper_css |
url | 【可选】自定义swiper的CSS依赖链接 |
swiper_js |
url | 【可选】自定义swiper的JS依赖链接 |
custom_css |
url | 【可选】主题适配样式补丁 |
custom_js |
url | 【可选】swiper初始化方法脚本 |
📝 使用方法
在需要置顶的文章的front-matter中添加swiper_index
配置项:
|
|
💫 总结
本指南详细介绍了26种Hexo博客美化技巧,从基础的样式修改到高级的交互效果,全方位提升博客的视觉体验和用户体验。
🔧 使用建议
- 按需启用:根据实际需求选择合适的功能
- 逐步测试:每次只添加一个功能并进行测试
- 定期备份:修改前备份原始文件
- 自定义调整:根据个人喜好调整参数和样式
📚 学习资源
🎉 祝你的博客美化之旅顺利!如有问题,欢迎在评论区交流讨论。