
Tag Plugins Plus
如有使用了本站的外挂标签插件的读者,请确保自己的配置内容为最新。
同理,若您在使用本帖教程后,发现样式无法完全还原文档内效果,请重点排查您的其余第三方魔改css样式,例如css中是否存在circle、square等易重class名。
安装插件,在博客根目录,运行以下指令
1
npm install hexo-butterfly-tag-plugins-plus --save
hexo自带的markdown渲染插件hexo-renderer-marked与外挂标签语法的兼容性较差,建议替换成hexo-renderer-kramed
添加配置信息,以下为写法示例
在站点配置文件_config.yml
或者主题配置文件_config.butterfly.yml
中添加1
2
3
4
5
6
7
8
9
10
11
12
13
14
15# tag-plugins-plus
# see https://akilar.top/posts/615e2dec/
tag_plugins:
enable: true # 开关
priority: 5 #过滤器优先权
issues: false #issues标签依赖注入开关
link:
placeholder: /img/link.png #link_card标签默认的图标图片
CDN:
anima: https://npm.elemecdn.com/hexo-butterfly-tag-plugins-plus@latest/lib/assets/font-awesome-animation.min.css #动画标签anima的依赖
jquery: https://npm.elemecdn.com/jquery@latest/dist/jquery.min.js #issues标签依赖
issues: https://npm.elemecdn.com/hexo-butterfly-tag-plugins-plus@latest/lib/assets/issues.js #issues标签依赖
iconfont: //at.alicdn.com/t/font_2032782_8d5kxvn09md.js #参看https://akilar.top/posts/d2ebecef/
carousel: https://npm.elemecdn.com/hexo-butterfly-tag-plugins-plus@latest/lib/assets/carousel-touch.js
tag_plugins_css: https://npm.elemecdn.com/hexo-butterfly-tag-plugins-plus@latest/lib/tag_plugins.css- 参数释义
参数 | 备选值/类型 | 释义 |
---|---|---|
enable | true/false | 【必选】控制开关 |
priority | number | 【可选】过滤器优先级,数值越小,执行越早,默认为10,选填 |
issues | true/false | 【可选】issues标签控制开关,默认为false |
link.placeholder | 【必选】link卡片外挂标签的默认图标 | |
CDN.anima | URL | 【可选】动画标签anima的依赖 |
CDN.jquery | URL | 【可选】issues标签依赖 |
CDN.issues | URL | 【可选】issues标签依赖 |
CDN.iconfont | URL | 【可选】iconfont标签symbol样式引入,如果不想引入,则设为false |
CDN.carousel | URL | 【可选】carousel旋转相册标签鼠标拖动依赖,如果不想引入则设为false |
CDN.tag_plugins_css | URL | 【可选】外挂标签样式的CSS依赖,为避免CDN缓存延迟,建议将@latest改为具体版本号 |
行内文本样式 text
1 | {% u 文本内容 %} |
- 带 下划线 的文本
- 带
着重号 的文本 - 带
波浪线 的文本 - 带
删除线的文本 - 键盘样式的文本 command + D
- 密码样式的文本:
这里没有验证码
1 | 1. 带 {% u 下划线 %} 的文本 |
行内文本 span
1 | {% span 样式参数(参数以空格划分), 文本内容 %} |
- 字体: logo, code
- 颜色: 红色、黄色、绿色、青色、蓝色、灰色
- 大小: small, h4, h3, h2, h1, large, huge, ultra
- 对齐方向: left, center, right
1 | - 彩色文字 |
段落文本 p
1 | {% p 样式参数(参数以空格划分), 文本内容 %} |
- 字体: logo, code
- 颜色:
红色
黄色
绿色
青色
蓝色
灰色
- 大小: small, h4, h3, h2, h1, large, huge, ultra
- 对齐方向: left, center, right
1 | - 彩色文字 |
引用 note
最新版butterfly
标签支持引用fontawesome V5
图标,效果上已经优于volantis
的note
标签。故不再额外引入volantis
的note样式。做样式适配好麻烦的啊,能偷懒就偷懒吧
以下是butterfly
主题的note
写法。
- 方法一
1
2
3{% note [class] [no-icon] [style] %}
Any content (support inline tags too.io).
{% endnote %} - 方法二
1
2
3{% note [color] [icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}
参数 | 用法 |
---|---|
class | 【可选】标识,不同的标识有不同的配色( default / primary / success / info / warning / danger ) |
no-icon | 【可选】可配置自定义 icon (只支持 fontawesome 图标, 也可以配置 no-icon ) |
style | 【可选】可以覆盖配置中的 style(simple/modern/flat/disabled) |
simple格式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
1 | {% note simple %}默认 提示块标签{% endnote %} |
modern样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
1 | {% note modern %}默认 提示块标签{% endnote %} |
flat样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
1 | {% note flat %}默认 提示块标签{% endnote %} |
disabled样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
1 | {% note disabled %}默认 提示块标签{% endnote %} |
no-icon样式
1 | {% note no-icon %}默认 提示块标签{% endnote %} |
simple格式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
1 | {% note 'fab fa-cc-visa' simple %}你是刷 Visa 还是 UnionPay{% endnote %} |
modern样式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
1 | {% note 'fab fa-cc-visa' modern %}你是刷 Visa 还是 UnionPay{% endnote %} |
flat样式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
1 | {% note 'fab fa-cc-visa' flat %}你是刷 Visa 还是 UnionPay{% endnote %} |
disabled样式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
1 | {% note 'fab fa-cc-visa' disabled %}你是刷 Visa 还是 UnionPay{% endnote %} |
no-icon样式
1 | {% note no-icon %}你是刷 Visa 还是 UnionPay{% endnote %} |
上标标签 tip
主要样式参考自小康的butterfly
渐变背景标签,自己写了个tip.js
来渲染标签,精简了一下代码。
1 | {% tip [参数,可选] %}文本内容{% endtip %} |
- 样式: success、error、warning、bolt、ban、home、sync、cogs、key、bell
- 自定义图标: 支持fontawesome
info
success
error
warning
bolt
ban
home
sync
cogs
key
bell
自定义font awesome图标
1 | {% tip info %}info{% endtip %} |
动态标签 anima
动态标签的实质是引用了font-awesome-animation的css样式,不一定局限于tip标签,也可以是其他标签。
只不过这里tip.js是我自己写的,所以我清楚它会怎么被渲染成html,才用的这个写法。
可以熟读文档,使用html语言来编写其他标签类型。
1 | {% tip [参数,可选] %}文本内容{% endtip %} |
- On DOM load(当页面加载时显示动画)
warning
ban
- 调整动画速度
warning
ban
- On hover(当鼠标悬停时显示动画)
warning
ban
- On parent hover(当鼠标悬停在父级元素时显示动画)
warning
ban
- On DOM load(当页面加载时显示动画)
1
2{% tip warning faa-horizontal animated %}warning{% endtip %}
{% tip ban faa-flash animated %}ban{% endtip %} - 调整动画速度
1
2{% tip warning faa-horizontal animated faa-fast %}warning{% endtip %}
{% tip ban faa-flash animated faa-slow %}ban{% endtip %} - On hover(当鼠标悬停时显示动画)
1
2{% tip warning faa-horizontal animated-hover %}warning{% endtip %}
{% tip ban faa-flash animated-hover %}ban{% endtip %} - On parent hover(当鼠标悬停在父级元素时显示动画)
1
2{% tip warning faa-parent animated-hover %}<p class="faa-horizontal">warning</p>{% endtip %}
{% tip ban faa-parent animated-hover %}<p class="faa-flash">ban</p>{% endtip %}
复选列表 checkbox
1 | {% checkbox 样式参数(可选), 文本(支持简单md) %} |
- 样式: plus, minus, times
- 颜色: red、yellow、green、cyan、blue、gray
- 选中状态: checked
1 | {% checkbox 纯文本测试 %} |
单选列表 radio
1 | {% radio 样式参数(可选), 文本(支持简单md) %} |
- 颜色: red、yellow、green、cyan、blue、gray
- 选中状态: checked
1 | {% radio 纯文本测试 %} |
时间轴 timeline
1 | {% timeline 时间线标题(可选)[,color] %} |
参数 | 解释 |
---|---|
title | 标题/时间线 |
color | timeline 颜色:default(留空) / blue / pink / red / purple / orange / green |
时间轴样式
2020-07-24 2.6.6 -> 3.0
- 如果有
hexo-lazyload-image
插件,需要删除并重新安装最新版本,设置lazyload.isSPA: true
。 - 2.x 版本的 css 和 js 不适用于 3.x 版本,如果使用了
use_cdn: true
则需要删除。 - 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。
- 2.x 版本的置顶
top: true
改为了pin: true
,并且同样适用于layout: page
的页面。 - 如果使用了
hexo-offline
插件,建议卸载,3.0 版本默认开启了 pjax 服务。
2020-05-15 2.6.3 -> 2.6.6
不需要额外处理。
2020-04-20 2.6.2 -> 2.6.3
- 全局搜索
seotitle
并替换为seo_title
。 - group 组件的索引规则有变,使用 group 组件的文章内,
group: group_name
对应的组件名必须是group_name
。 - group 组件的列表名优先显示文章的
short_title
其次是title
。
1 | {% timeline 时间轴样式,blue %} |
链接卡片 link
1 | {% link 标题, 链接, 图片链接(可选) %} |
1 | {% link 满心, https://blog.lovelu.top, https://blog.lovelu.top,https://bu.dusays.com/2022/12/15/639a81c28f3bc.png %} |
按钮 btns
Volantis
的按钮使用的是btn
和btns
标签。btns
和butterfly
的button
不冲突,但是btn
会被强制渲染,导致部分参数失效,而且btn
的效果还是butterfly
的button
更好看些。所以就只适配了btns
。
1 | {% btns 样式参数 %} |
参数 | 含义 |
---|---|
wide | 宽一点的按钮 |
fill | 填充布局,自动铺满至少一行,多了会换行 |
center | 居中,按钮之间是固定间距 |
around | 居中分散 |
grid2 | 等宽最多2列,屏幕变窄会适当减少列数 |
grid3 | 等宽最多3列,屏幕变窄会适当减少列数 |
grid4 | 等宽最多4列,屏幕变窄会适当减少列数 |
grid5 | 等宽最多5列,屏幕变窄会适当减少列数 |
- 如果需要显示类似「团队成员」之类的一组含有头像的链接:
- 或者含有图标的按钮
- 圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中
- 如果需要显示类似「团队成员」之类的一组含有头像的链接:
1
2
3
4
5
6
7{% btns circle grid5 %}
{% cell xaoxuu, https://xaoxuu.com, https://bu.dusays.com/2022/12/15/639a81c28f3bc.png %}
{% cell xaoxuu, https://xaoxuu.com, https://bu.dusays.com/2022/12/15/639a81c28f3bc.png %}
{% cell xaoxuu, https://xaoxuu.com, https://bu.dusays.com/2022/12/15/639a81c28f3bc.png %}
{% cell xaoxuu, https://xaoxuu.com, https://bu.dusays.com/2022/12/15/639a81c28f3bc.png %}
{% cell xaoxuu, https://xaoxuu.com, https://bu.dusays.com/2022/12/15/639a81c28f3bc.png %}
{% endbtns %} - 或者含有图标的按钮
1
2
3
4{% btns rounded grid5 %}
{% cell 下载源码, /, fas fa-download %}
{% cell 查看文档, /, fas fa-book-open %}
{% endbtns %} - 圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中
1
2
3
4
5
6
7
8
9
10
11
12
13
14{% btns circle center grid5 %}
<a href='https://apps.apple.com/cn/app/heart-mate-pro-hrm-utility/id1463348922?ls=1'>
<i class='fab fa-apple'></i>
<b>心率管家</b>
{% p red, 专业版 %}
<img src='https://bu.dusays.com/2022/12/15/639a81c28f3bc.png'>
</a>
<a href='https://apps.apple.com/cn/app/heart-mate-lite-hrm-utility/id1475747930?ls=1'>
<i class='fab fa-apple'></i>
<b>心率管家</b>
{% p green, 免费版 %}
<img src='https://bu.dusays.com/2022/12/15/639a81c28f3bc.png'>
</a>
{% endbtns %}
网站卡片 sites
1 | {% sitegroup %} |
1 | {% sitegroup %} |
音频Audio
1 | {% audio 音频链接 %} |
1 | {% audio https://img.lovelu.top/hexo-blog/music/Lumia1020.mp3 %} |
视频 video
1 | {% video 视频链接 %} |
- 对其方向:left, center, right
- 列数:逗号后面直接写列数,支持 1 ~ 4 列。
- 100%宽度
- 50%宽度
- 25%宽度
- 100%宽度
1
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
- 50%宽度
1
2
3
4
5
6{% videos, 2 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% endvideos %} - 25%宽度
1
2
3
4
5
6
7
8
9
10{% videos, 4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% video https://img.lovelu.top/hexo-blog/video/love_video.mp4 %}
{% endvideos %}
github徽标 ghbdage
1 | {% bdage [right],[left],[logo]||[color],[link],[title]||[option] %} |
left
:徽标左边的信息,必选参数。right
: 徽标右边的信息,必选参数,logo
:徽标图标,图标名称详见simpleicons,可选参数。color
:徽标右边的颜色,可选参数。link
:指向的链接,可选参数。title
:徽标的额外信息,可选参数。主要用于优化SEO,但object
标签不会像a
标签一样在鼠标悬停显示title信息。option
:自定义参数,支持shields.io的全部API参数支持,具体参数可以参看上文中的拓展写法示例。形式为name1=value2&name2=value2
。
- 基本参数
- 信息参数
- 拓展参数
- 基本参数,定义徽标左右文字和图标
1
2{% bdage Theme,Butterfly %}
{% bdage Frame,Hexo,hexo %} - 信息参数,定义徽标右侧内容背景色,指向链接
1
2
3{% bdage CDN,JsDelivr,jsDelivr||abcdef,https://metroui.org.ua/index.html,本站使用JsDelivr为静态资源提供CDN加速 %}
//如果是跨顺序省略可选参数,仍然需要写个逗号,用作分割
{% bdage Source,GitHub,GitHub||,https://github.com/ %} - 拓展参数,支持shields的API的全部参数内容
1
2
3{% bdage Hosted,Vercel,Vercel||brightgreen,https://vercel.com/,本站采用双线部署,默认线路托管于Vercel||style=social&logoWidth=20 %}
//如果是跨顺序省略可选参数组,仍然需要写双竖线||用作分割
{% bdage Hosted,Vercel,Vercel||||style=social&logoWidth=20&logoColor=violet %}
相册 gallery
- gallerygroup 相册图库
1
2
3
4
5<div class="gallery-group-main">
{% galleryGroup name description link img-url %}
{% galleryGroup name description link img-url %}
{% galleryGroup name description link img-url %}
</div> - gallery 相册
1
2
3{% gallery %}
markdown 圖片格式
{% endgallery %}
- gallerygroup 相册图库
参数名 | 释义 |
---|---|
name | 图库名字 |
description | 图库描述 |
link | 链接到对应相册的地址 |
img-url | 图库封面 |
- gallerygroup 相册图库
1
2
3
4<div class="gallery-group-main">
{% galleryGroup '养眼' '存在于虚拟世界的你' '/gallery/girl' 'https://bu.dusays.com/2022/12/22/63a3ca068973a.jpg' %}
{% galleryGroup '游戏' '君临天下-为中国一战' '/gallery/junlin' 'https://bu.dusays.com/2022/12/27/63aa4960760fa.webp' %}
</div> - gallery 相册
1
2
3
4
5
6
7
8
9
10{% gallery %}








{% endgallery %}
折叠框 folding
1 | {% folding 参数(可选), 标题 %}{% endfolding %} |
- 颜色:blue, cyan, green, yellow, red
- 状态:状态填写 open 代表默认打开。
默认打开的折叠框
这是一个默认打开的折叠框。
默认关闭的折叠框
这是一个默认关闭的折叠框。
1 | {% folding open, 默认打开的折叠框 %}这是一个默认打开的折叠框。{% endfolding %} |
进度条 progress
1 | {% progress [width] [color] [text] %} |
- width: 0到100的阿拉伯数字
- color: 颜色,取值有red,yellow,green,cyan,blue,gray
- text:进度条上的文字内容
1 | {% progress 10 red 进度条样式预览 %} |
注释 notation
1 | {% nota [label] , [text] %} |
- label: 注释词汇
- text: 悬停显示的注解内容
把鼠标移动到我上面试试
1 | {% nota 把鼠标移动到我上面试试 ,可以看到注解内容出现在顶栏 %} |
- 感谢你赐予我前进的力量