npm插件安装

  1. 安装插件，在blog根目录下打开终端，运行以下指令：
1
npm install hexo -butterfly-tag-plugins-plus --save
  1. 更换hexo自带的markdown渲染插件hexo-renderer-marked与外挂标签语法的兼容性较差，于是将其更换成hexo-renderer-kramed
1
2
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save
  1. 添加配置信息，以下列写法为例。需要在主题配置文件_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/favicon.jpg #link_card标签默认的图标图片
  CDN:
    anima: https://cdn.cbd.int/hexo-butterfly-tag-plugins-plus@latest/lib/assets/font-awesome-animation.min.css #动画标签anima的依赖
    jquery: https://cdn.cbd.int/jquery@latest/dist/jquery.min.js #issues标签依赖
    issues: https://cdn.cbd.int/hexo-butterfly-tag-plugins-plus@latest/lib/assets/issues.js #issues标签依赖
    iconfont: //at.alicdn.com/t/c/font_3626212_ybdjq34pf6.css #参看https://akilar.top/posts/d2ebecef/
    carousel: https://cdn.cbd.int/hexo-butterfly-tag-plugins-plus@latest/lib/assets/carousel-touch.js
    tag_plugins_css: https://cdn.cbd.int/hexo-butterfly-tag-plugins-plus@latest/lib/tag_plugins.css
  1. 相关参数阐述：
参数备选值阐述
enabletrue/false【必选】控制开关
prioritynumber【可选】过滤器优先级，数值越小，执行越早，默认为5，选填
issuestrue/false【可选】issue标签控制开关，默认为false
linkpicture【必选】link卡片外挂标签的默认图标
CDN.animaURL【可选】动画标签anima的依赖
CDN.jqueryURL【可选】issue的标签依赖
CDN.iconfontURL【可选】iconfont标签symbol样式引入，如果不想引入，则设置为false
CDN.carouselURL【可选】carousel旋转相册标签鼠标拖动依赖，如果不想引入则设置为false
CDN.tag_plugins_cssURL【可选】外挂标签样式的CSS依赖，为避免CDN缓存延迟，建议将@latest改为具体版本号

外挂标签

分栏 Tab

Butterfly的分栏tab实际上是基于Next主题的分栏tab，写法和效果完全一致

1
2
3
4
5
6
7
8
9
{% tabs Unique name,[index] %}

<!-- tab [Tab caption] [@icon] -->

Any content (support inline tags too).

<!-- endtab -->

{% endtabs %}

1.Unique name：

  • 选项卡块标签的唯一名称，不带逗号。
  • 将在#id中用作每个标签及其索引号的前缀。
  • 如果名称中包含空格，则对于生成的#id，所有空格将由破折号代替。
  • 仅当前页面的URL必需是唯一的。

2.[index]：

  • 活动选项卡的索引号。
  • 如果未指定，则默认指定标签（1）。
  • 如果设置为-1，则为没有预设值，不选择标签。

3.[Tab caption]

  • 当前选项卡的标题。
  • 如果未指定标题，则将Unique name加上索引号作为当前选项卡标题。
  • 如果未指定标题，但选择了图标，则直接显示图标。

4.[@icron]

  • FontAwesome的图标名称。
  • 可以指定带空格和不带空格例如：’Tab caption @icon’ 和 ‘Tab caption@icon’。

Demo 1 ：默认预设为第一个分栏标签tab

This is Tab 1

This is Tab 2

This is Tab 3

Demo 2 ：预设初始状态为第三个分栏标签tab

This is Tab 1

This is Tab 2

This is Tab 3

Demo 3 ：不展开标签栏，不预设分栏标签tab

This is Tab 1

This is Tab 2

This is Tab 3

Demo 4 ：自定义tab名-只有icon，-icon和tab名

This is Tab 1,named 第一个Tab

只有图标没有tab的名字

This is Tab 3

Demo 1 ：默认预设为第一个分栏标签tab


1
2
3
4
5
6
7
8
9
10
11
{% tabs test1 %}
<!-- tab -->
**This is Tab 1**
<!-- endtab -->
<!-- tab -->
**This is Tab 2**
<!-- endtab -->
<!-- tab -->
**This is Tab 3**
<!-- endtab -->
{% endtabs %}

Demo 2 ：预设初始状态为第三个分栏标签tab


1
2
3
4
5
6
7
8
9
10
11
{% tabs test2,3 %}
<!-- tab -->
**This is Tab 1**
<!-- endtab -->
<!-- tab -->
**This is Tab 2**
<!-- endtab -->
<!-- tab -->
**This is Tab 3**
<!-- endtab -->
{% endtabs %}

Demo 3 ：不展开标签栏，不预设分栏标签tab


1
2
3
4
5
6
7
8
9
10
11
{% tabs test3,-1 %}
<!-- tab -->
**This is Tab 1**
<!-- endtab -->
<!-- tab -->
**This is Tab 2**
<!-- endtab -->
<!-- tab -->
**This is Tab 3**
<!-- endtab -->
{% endtabs %}

Demo 4 ：自定义tab名-只有icon，-icon和tab名


1
2
3
4
5
6
7
8
9
10
11
{% tabs test4 %}
<!-- tab 第一个tab -->
**This is Tab 1,named 第一个Tab**
<!-- endtab -->
<!-- tab @fab fa-apple-pay -->
**只有图标没有tab的名字**
<!-- endtab -->
<!-- tab 炸弹 @fas fa-bomb -->
**This is Tab 3**
<!-- endtab -->
{% endtabs %}

行内文本样式 text

1
2
3
4
5
6
{% u 文本内容 %}
{% emp 文本内容 %}
{% wavy 文本内容 %}
{% del 文本内容 %}
{% kbd 文本内容 %}
{% psw 文本内容 %}
  1. 带下划线的文本
  2. 带着重号的文本
  3. 带波浪线的文本
  4. 带删除线的文本
  5. 键盘样式的文本 ：command + D
  6. 密码样式的文本 ：这里没有密码
1
2
3
4
5
6
带{% u 下划线 %}的文本
带{% emp 着重号 %}的文本
带{% wavy 波浪线 %}的文本
带{% del 删除线 %}的文本
键盘样式的文本 ：{% kbd command %} + {% kbd D%}
密码样式的文本 ：{% psw 这里没有密码 %}

行内文本 span

1
{% span 样式参数（参数以空格划分）, 文本内容 %}

  1. 字体：logo，code

  2. 颜色：red , yellow , green , cyan , blue}

  3. 大小：small，h4，h3，h2，h1，large，huge，ultra

  4. 对其方向：left，center，right

  • 彩色文字

在一段话中方便插入各种颜色的标签，包括：红色 , 黄色 , 绿色 , 青色 , 蓝色 , 灰色

  • 超大号文字

文档 [开始]页面的文字就是超大号文字

A Wonderful Theme for Hexo

1
2
3
4
5
6
7
8
9
10

- 彩色文字
在一段话中方便插入各种颜色的标签，包括：{% span red , 红色 %} , {% span yellow , 黄色 %} , {% span green , 绿色 %} ,  {% span cyan , 青色 %} , {% span blue , 蓝色 %} , {% span gray , 灰色 %}

- 超大号文字
文档 [开始]页面的文字就是超大号文字

{% span center logo  huge , Volantis %}

{% span center small, A Wonderful Theme for Hexo %}

段落文本 p

1
{% p 样式参数（参数以空格划分），文本内容 %}

  1. 字体：logo，code

  2. 颜色：

    red

    ,

    yellow

    ,

    green

    ,

    cyan

    ,

    blue}

  3. 大小：small，h4，h3，h2，h1，large，huge，ultra

  4. 对其方向：left，center，right

  • 彩色文字

在一段话中方便插入各种颜色的标签，包括：

红色

,

黄色

,

绿色

,

青色

,

蓝色

,

灰色

  • 超大号文字

文档 [开始]页面的文字就是超大号文字

A Wonderful Theme for Hexo

1
2
3
4
5
6
7
8
9
10
11
- 彩色文字

在一段话中方便插入各种颜色的标签，包括：{% p red , 红色 %} , {% p yellow , 黄色 %} , {% p green , 绿色 %} ,  {% p cyan , 青色 %} , {% p blue , 蓝色 %} , {% p gray , 灰色 %}

- 超大号文字

文档 [开始]页面的文字就是超大号文字

{% p center logo  huge , Volantis %}

{% p center small, A Wonderful Theme for Hexo %}

引用 note

方法一与方法二的主要区别在于有无icon，即有无自定义图标

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Note (Bootstrap Callout)

note:
  # Note tag style values:
  #  - simple    bs-callout old alert style. Default.
  #  - modern    bs-callout new (v2-v3) alert style.
  #  - flat      flat callout style with background, like on Mozilla or StackOverflow.
  #  - disabled  disable all CSS styles import of note tag.
  style: simple
  icons: false
  border_radius: 3
  # Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).
  # Offset also applied to label tag variables. This option can work with disabled note tag.
  light_bg_offset: 0
方法一
1
2
3
{% note [class] [no-icon] [style] %}
Any content (support inline tags to.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
style[可选] 可以覆盖配置中的style ( simple / modern / flat / disabled )
方法二
参数用法
class[可选] 标识 , 不同的标识有不同的配色 ( default / primary / success / info / warning / danger)
icon[可选] 可配置自定义icon(只支持fontawsome 图标 , 也可以配置 no-icon)
style[可选] 可以覆盖配置中的 style (simple / modern / flat / disabled)
方法一
  1. simple样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

  1. modern样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

  1. flat样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

  1. disabled样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

  1. no-icon样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

方法二
  1. simple样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

  1. modern样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

  1. flat样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

  1. disabled样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

  1. no-icon样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

方法一
  1. simple样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note simple %}默认 提示块标签{% endnote %}

{% note default simple %}default 提示块标签{% endnote %}

{% note primary simple %}primary 提示块标签{% endnote %}

{% note success simple %}success 提示块标签{% endnote %}

{% note info simple %}info 提示块标签{% endnote %}

{% note warning simple %}warning 提示块标签{% endnote %}

{% note danger simple %}danger 提示块标签{% endnote %}
  1. modern样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note modern %}默认 提示块标签{% endnote %}

{% note default modern %}default 提示块标签{% endnote %}

{% note primary modern %}primary 提示块标签{% endnote %}

{% note success modern %}success 提示块标签{% endnote %}

{% note info modern %}info 提示块标签{% endnote %}

{% note warning modern %}warning 提示块标签{% endnote %}

{% note danger modern %}danger 提示块标签{% endnote %}
  1. flat样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note flat %}默认 提示块标签{% endnote %}

{% note default flat %}default 提示块标签{% endnote %}

{% note primary flat %}primary 提示块标签{% endnote %}

{% note success flat %}success 提示块标签{% endnote %}

{% note info flat %}info 提示块标签{% endnote %}

{% note warning flat %}warning 提示块标签{% endnote %}

{% note danger flat %}danger 提示块标签{% endnote %}
  1. disabled样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note disabled %}默认 提示块标签{% endnote %}

{% note default disabled %}default 提示块标签{% endnote %}

{% note primary disabled %}primary 提示块标签{% endnote %}

{% note success disabled %}success 提示块标签{% endnote %}

{% note info disabled %}info 提示块标签{% endnote %}

{% note warning disabled %}warning 提示块标签{% endnote %}

{% note danger disabled %}danger 提示块标签{% endnote %}
  1. no-icon样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note no-icon %}默认 提示块标签{% endnote %}

{% note default no-icon %}default 提示块标签{% endnote %}

{% note primary no-icon %}primary 提示块标签{% endnote %}

{% note success no-icon %}success 提示块标签{% endnote %}

{% note info no-icon %}info 提示块标签{% endnote %}

{% note warning no-icon %}warning 提示块标签{% endnote %}

{% note danger no-icon %}danger 提示块标签{% endnote %}
方法二
  1. simple样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note 'fab fa-cc-visa' simple %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' simple %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' simple %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' simple%}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' simple %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' simple %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' simple %}前端最讨厌的浏览器{% endnote %}
  1. modern样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note 'fab fa-cc-visa' modern %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' modern %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' modern %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' modern%}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' modern %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' modern %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' modern %}前端最讨厌的浏览器{% endnote %}
  1. flat样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note 'fab fa-cc-visa' flat %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' flat %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' flat %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' flat%}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' flat %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' flat %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' flat %}前端最讨厌的浏览器{% endnote %}
  1. disabled样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note 'fab fa-cc-visa' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue 'fas fa-bullhorn' disabled %}2021年快到了....{% endnote %}

{% note pink 'fas fa-car-crash' disabled %}小心开车 安全至上{% endnote %}

{% note red 'fas fa-fan' disabled %}这是三片呢？还是四片？{% endnote %}

{% note orange 'fas fa-battery-half' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple 'far fa-hand-scissors' disabled %}剪刀石头布{% endnote %}

{% note green 'fab fa-internet-explorer' disabled %}前端最讨厌的浏览器{% endnote %}
  1. no-icon样式
1
2
3
4
5
6
7
8
9
10
11
12
13
{% note no-icon %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note blue no-icon %}2021年快到了....{% endnote %}

{% note pink no-icon %}小心开车 安全至上{% endnote %}

{% note red no-icon %}这是三片呢？还是四片？{% endnote %}

{% note orange no-icon %}你是刷 Visa 还是 UnionPay{% endnote %}

{% note purple no-icon %}剪刀石头布{% endnote %}

{% note green no-icon %}前端最讨厌的浏览器{% endnote %}

上标标签 tip

1
{% tip [参数，可选] %}文本内容{% endtip %}
  1. 样式：success，error，warning，bolt，home，sync，cogs，key，bell
  2. 自定义图标：支持fontawesome。

default

info

success

error

warning

bolt

ban

home

sync

key

bell

自定义font awesome图标

1
2
3
4
5
6
7
8
9
10
11
12
{% tip %}default{% endtip %}
{% tip info %}info{% endtip %}
{% tip success %}success{% endtip %}
{% tip error %}error{% endtip %}
{% tip warning %}warning{% endtip %}
{% tip bolt %}bolt{% endtip %}
{% tip ban %}ban{% endtip %}
{% tip home %}home{% endtip %}
{% tip sync %}sync{% endtip %}
{% tip key %}key{% endtip %}
{% tip bell %}bell{% endtip %}
{% tip fa-atom %}自定义font awesome图标{% endtip %}

动态标签 anima

动态标签的实质是引用了font-awesome-animation的css样式，不一定局限于tip标签，也可以是其他标签。

1
{% tip [参数 , 可选] %}文本内容{% endtip %}
  1. 将所需的CSS类添加到图标(或DOM中的任何元素)。
  2. 对于父级悬停样式，需要给目标元素添加指定CSS类，同时还要给目标元素的父级元素添加CSS类faa-parent animated-hover。
  3. 可以通过给目标元素添加CSS类faa-fast或faa-slow来控制动画快慢。
  1. On DOM load

warning

  1. On DOM load（当页面加载时显示动画）
1
2
{% tip warning faa-horizontal animated %}warning{% endtip %}
{% tip ban faa-flash animated %}ban{% endtip %}
  1. 调整动画速度
1
2
{% tip warning faa-horizontal animated faa-fast %}warning{% endtip %}
{% tip ban faa-flash animated faa-slow %}ban{% endtip %}
  1. On hover
1
{% tip  %}