Hexo-Theme-Butterfly Tag Plugins Demo

Hexo-Theme-Butterfly Tag Plugins Demo


Butterfly主题的独有功能,它并不属于标准的MarkDown格式.

​ 这里只记录每种插件具体的用法

Last Update Version Dev 4.2.2

Note (Bootstrap Callout)

_config.butterfly.yml

1
2
3
4
5
6
7
8
9
10
11
12
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

​ icons 和 light_bg_offset只对方法一生效

格式

1
2
3
{% note [class] [no-icon] [style] %}
修饰语句
{% endnote %}

使用方法解析

属性 值/用法
class 样式
default/primary/success/info/warning/danger
no-icon 不显示图标
style 覆盖主题配置中的style
simple/modern/flat/disabled

style:simple示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{% 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 %}

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

style:modern示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{% 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 %}

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

style:flat示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{% 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 %}

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

style:disabled示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{% 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 %}

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签


Gallery相册图库

格式

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>

属性解析

name 图库名字
description 图库描述
link 图库链接地址
img-url 封面

Demo

1
2
3
<div class="gallery-group-main">
{% galleryGroup '封面' '文章封面' '/Gallery/wallpaper' https://i.loli.net/2019/11/10/T7Mu8Aod3egmC4Q.png %}
</div>

Gallery相册

格式

1
2
3
{% gallery %}
markdown 图片格式
{% endgallery %}

Demo

1
2
3
{% gallery %}
![](https://i.loli.net/2019/11/10/T7Mu8Aod3egmC4Q.png)
{% endgallery %}

tag-hide

请注意,tag-hide内的标签外挂content内都不建议有h1 - h6 等标题。因为Toc会把隐藏内容标题也显示出来,而且当滚动屏幕时,如果隐藏内容没有显示出来,会导致Toc的滚动出现异常。

用于把一些文字、内容隐藏起来,提供按钮点击显示。

inline格式

1
{% hideInline content,display,bg,color %}

inline 在文本里面添加按钮隐藏内容,只限文字

( content不能包含英文逗号,可用&sbquo;)

属性解析

content 文本内容
display 按钮显示的文字(可选)
bg 按钮的背景颜色(可选)
color 按钮文字的颜色(可选)

Demo

1
2
The Top1 of HLTV 2019? {% hideInline Zywoo,查看答案,#FF7242,#fff %}
The Top1 of HLTV 2020? {% hideInline Zywoo %}

The Top1 of HLTV 2019? Zywoo

The Top1 of HLTV 2020? Zywoo

block格式

block独立的block隐藏内容,可以隐藏很多内容,包括图片,代码块等等

( display 不能包含英文逗号,可用&sbquo;)

格式

1
2
3
{% hideBlock display,bg,color %}
content
{% endhideBlock %}

属性同上

Demo

1
2
3
4
Catch Top1
{% hideBlock HLTV2021 %}
![](https://img-cdn.hltv.org/playerbodyshot/Q2u6AgnDNYQ3dyObwN4JBX.png?ixlib=java-2.1.0&w=400&s=5e19fa63867872bd78409f6e757ff6c3)
{% endhideBlock %}

Catch Top1

Toggle格式

如果你需要展示的内容太多,可以把它隐藏在收缩框里,需要时再把它展开。

( display 不能包含英文逗号,可用&sbquo;)

1
2
3
{% hideToggle display,bg,color %}
content
{% endhideToggle %}

属性同上

Demo

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{% hideToggle HLTV历年Top1 %}
2010年Yegor "markeloff" Markelov.
场均rating:1.22
场均击杀数:0.78


2011年 Filip "Neo" Kubski
场均rating:1.24
场均击杀数:0.82
时年24岁

2013年 Christopher "GeT_RiGhT" Alesund
场均rating:1.30
场均击杀数:0.85


2014年 Christopher "GeT_RiGhT" Alesund
场均rating :1.13
场均击杀数 :0.77


2015年 Olof'olofmeister' Kajbjer
场均rating:1.14
场均击杀数:0.79


2016年 Marcelo "coldzera" David
场均rating:1.15
场均击杀数:0.80


2017年 Marcelo "coldzera" David
场均rating:1.24
场均击杀:0.82


2018年 Aleksandr "⁠s1mple⁠" Kostyliev
场均rating:1.33
场均击杀:0.87


2019年 Mathieu "⁠ZywOo⁠" Herbaut
场均rating:1.30
场均击杀:0.83


{% endhideToggle %}
HLTV历年Top1

2010年Yegor “markeloff” Markelov.
场均rating:1.22
场均击杀数:0.78

2011年 Filip “Neo” Kubski
场均rating:1.24
场均击杀数:0.82
时年24岁

2013年 Christopher “GeT_RiGhT” Alesund
场均rating:1.30
场均击杀数:0.85

2014年 Christopher “GeT_RiGhT” Alesund
场均rating :1.13
场均击杀数 :0.77

2015年 Olof’olofmeister’ Kajbjer
场均rating:1.14
场均击杀数:0.79

2016年 Marcelo “coldzera” David
场均rating:1.15
场均击杀数:0.80

2017年 Marcelo “coldzera” David
场均rating:1.24
场均击杀:0.82

2018年 Aleksandr “⁠s1mple⁠” Kostyliev
场均rating:1.33
场均击杀:0.87

2019年 Mathieu “⁠ZywOo⁠” Herbaut
场均rating:1.30
场均击杀:0.83

Tabs

格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% tabs Unique name, [index] %}
<!-- tab [Tab caption] [@icon] -->
Any content (support inline tags too).
<!-- endtab -->
{% endtabs %}

Unique name : Unique name of tabs block tag without comma.
Will be used in #id's as prefix for each tab with their index numbers.
If there are whitespaces in name, for generate #id all whitespaces will replaced by dashes.
Only for current url of post/page must be unique!
[index] : Index number of active tab.
If not specified, first tab (1) will be selected.
If index is -1, no tab will be selected. It's will be something like spoiler.
Optional parameter.
[Tab caption] : Caption of current tab.
If not caption specified, unique name with tab index suffix will be used as caption of tab.
If not caption specified, but specified icon, caption will empty.
Optional parameter.
[@icon] : FontAwesome icon name (full-name, look like 'fas fa-font')
Can be specified with or without space; e.g. 'Tab caption @icon' similar to 'Tab caption@icon'.
Optional parameter.

Demo-默认选择第一项

1
2
3
4
5
6
7
8
9
10
11
12
13
{% tabs Top Stars %}
<!-- tab -->
Top 1 Simple
<!-- endtab -->

<!-- tab -->
Top 2 Zywoo
<!-- endtab -->

<!-- tab -->
Top 3 Niko
<!-- endtab -->
{% endtabs %}

Top 1 Simple

Top 2 Zywoo

Top 3 Niko

Demo-指定选择的项

1
2
3
4
5
6
7
8
9
10
11
12
13
{% tabs Top Stars, 3 %}
<!-- tab -->
Top 1 Simple
<!-- endtab -->

<!-- tab -->
Top 2 Zywoo
<!-- endtab -->

<!-- tab -->
Top 3 Niko
<!-- endtab -->
{% endtabs %}

Top 1 Simple

Top 2 Zywoo

Top 3 Niko

Demo-不选中

1
2
3
4
5
6
7
8
9
10
11
12
13
{% tabs Top Stars, -1 %}
<!-- tab -->
Top 1 Simple
<!-- endtab -->

<!-- tab -->
Top 2 Zywoo
<!-- endtab -->

<!-- tab -->
Top 3 Niko
<!-- endtab -->
{% endtabs %}

Top 1 Simple

Top 2 Zywoo

Top 3 Niko

Demo-自定义Tab名

1
2
3
4
5
6
7
8
9
10
11
12
13
{% tabs 斗地主 %}
<!-- tab 3 -->
**tab名字为第一个Tab**
<!-- endtab -->

<!-- tab @fa-solid fa-2 -->
**只有图标 没有Tab名字**
<!-- endtab -->

<!-- tab 王炸@fas fa-bomb -->
**名字+icon**
<!-- endtab -->
{% endtabs %}

单走一张3

2

王炸

Button

格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{% btn [url],[text],[icon],[color] [style] [layout] [position] [size] %}

[url] : 链接
[text] : 按钮文字
[icon] : [可选] 图标
[color] : [可选] 按钮背景顔色(默认style时)
按钮字体和边框顔色(outline时)
default/blue/pink/red/purple/orange/green
[style] : [可选] 按钮样式 默认实心
outline/留空
[layout] : [可选] 按钮佈局 默认为line
block/留空
[position] : [可选] 按钮位置 前提是设置了layout为block 默认为左边
center/right/留空
[size] : [可选] 按钮大小
larger/留空

Demo

1
2
3
4
5
This is my website, click the button {% btn '#',Butterfly %}
This is my website, click the button {% btn '#',Butterfly,far fa-hand-point-right %}
This is my website, click the button {% btn '#',Butterfly,,outline %}
This is my website, click the button {% btn '#',Butterfly,far fa-hand-point-right,outline %}
This is my website, click the button {% btn '#',Butterfly,far fa-hand-point-right,larger %}

This is my website, click the button Butterfly
This is my website, click the button Butterfly
This is my website, click the button Butterfly
This is my website, click the button Butterfly
This is my website, click the button Butterfly

Demo

1
2
3
{% btn '#',Butterfly,far fa-hand-point-right,block %}
{% btn '#',Butterfly,far fa-hand-point-right,block center larger %}
{% btn '#',Butterfly,far fa-hand-point-right,block right outline larger %}
Butterfly Butterfly Butterfly

Demo

1
2
3
4
5
6
7
{% btn '#',Butterfly,far fa-hand-point-right,larger %}
{% btn '#',Butterfly,far fa-hand-point-right,blue larger %}
{% btn '#',Butterfly,far fa-hand-point-right,pink larger %}
{% btn '#',Butterfly,far fa-hand-point-right,red larger %}
{% btn '#',Butterfly,far fa-hand-point-right,purple larger %}
{% btn '#',Butterfly,far fa-hand-point-right,orange larger %}
{% btn '#',Butterfly,far fa-hand-point-right,green larger %}
Butterfly Butterfly Butterfly Butterfly Butterfly Butterfly Butterfly

Demo

1
2
3
4
5
6
7
8
9
<div class="btn-center">
{% btn '#',Butterfly,far fa-hand-point-right,outline larger %}
{% btn '#',Butterfly,far fa-hand-point-right,outline blue larger %}
{% btn '#',Butterfly,far fa-hand-point-right,outline pink larger %}
{% btn '#',Butterfly,far fa-hand-point-right,outline red larger %}
{% btn '#',Butterfly,far fa-hand-point-right,outline purple larger %}
{% btn '#',Butterfly,far fa-hand-point-right,outline orange larger %}
{% btn '#',Butterfly,far fa-hand-point-right,outline green larger %}
</div>

inlineImg

图片以块级元素显示改为以内联元素显示

格式

1
2
3
4
{% inlineImg [src] [height] %}

[src] : 图片链接
[height] : 图片高度限制【可选】

Demo

1
2
3
4
5
又到了这个季节

![](https://s2.loli.net/2022/06/12/lcWDMqo8upCrRAw.jpg)

故乡的樱花开了,你不回去看看么 {% inlineImg https://s2.loli.net/2022/06/10/jrcMLDAiTtQWz6Z.jpg %}

又到了这个季节

故乡的樱花开了,你不回去看看么

label

高亮所需的文字

格式

1
{% label text color %}

属性解析

参数 解析
text 修饰文字
color 【可选】背景颜色,默认为 default
default/blue/pink/red/purple/orange/green

Demo

1
诺手连招:{% label A %}接{% label W blue %}接{% label 外圈刮 pink %}接{% label A red %}接{% label 无情铁手 purple %}接{% label A orange %}接{% label 一刀斩 green %}.

诺手连招:AW外圈刮A无情铁手A一刀斩 .

timeline

格式

1
2
3
4
5
6
7
8
{% timeline title,color %}
<!-- timeline title -->
xxxxx
<!-- endtimeline -->
<!-- timeline title -->
xxxxx
<!-- endtimeline -->
{% endtimeline %}

属性解析

属性 解析
title 标题/时间线
color timeline 颜色
default(留空) / blue / pink / red / purple / orange / green

Demo

1
2
3
4
5
{% timeline 2022 %}
<!-- timeline 01-02 -->
这是测试页面
<!-- endtimeline -->
{% endtimeline %}

2022

06-16

这是测试页面

Demo

1
2
3
4
5
{% timeline 2022,pink %}
<!-- timeline 01-02 -->
这是测试页面
<!-- endtimeline -->
{% endtimeline %}

2022

06-16

这是测试页面

可在任何界面插入类似友情链接列表效果

内容格式与友情链接界面一样,支持 yml 格式

格式

1
2
3
{% flink %}
xxxxxx
{% endflink %}

Demo

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{% flink %}
- class_name: 友情链接
class_desc: 那些人,那些事
link_list:
- name: Zelas2Xerath
link: https://blog.806006.xyz
avatar: https://blog.806006.xyz/img/avatar.png
descr: 今日事,今日毕

- class_name: 网站
class_desc: 值得推荐的网站
link_list:
- name: Bilibili
link: https://www.bilibili.com
avatar: https://www.bilibili.com/favicon.ico
descr: 视频网站
{% endflink %}

mermaid

使用mermaid标籤可以绘製Flowchart(流程图)、Sequence diagram(时序图 )、Class Diagram(类别图)、State Diagram(状态图)、Gantt(甘特图)和Pie Chart(饼状图)

Mermaid 是一个基于 Javascript 的图表绘制工具,通过解析类 Markdown 的文本语法来实现图表的创建和动态修改。Mermaid 诞生的主要目的是让文档的更新能够及时跟上开发进度。

Doc-Rot 是 Mermaid 致力于解决的一个难题。

绘图和编写文档花费了开发者宝贵的开发时间,而且随着业务的变更,它很快就会过期。 但是如果缺少了图表或文档,对于生产力和团队新人的业务学习都会产生巨大的阻碍。
Mermaid 通过允许用户创建便于修改的图表来解决这一难题,它也可以作为生产脚本(或其他代码)的一部分。

修改主题配置文件

1
2
3
4
5
6
7
8
9
# mermaid
# see https://github.com/mermaid-js/mermaid
mermaid:
enable: true
# built-in themes: default/forest/dark/neutral
theme:
light: default
dark: dark

格式

1
2
3
{% mermaid %}
内容
{% endmermaid %}

Demo-流程图

1
2
3
4
5
6
7
{% mermaid %}
flowchart LR
A[Hard] -->|Text| B(Round)
B --> C{Decision}
C -->|One| D[Result 1]
C -->|Two| E[Result 2]
{% endmermaid %}

Demo-时序图

1
2
3
4
5
6
7
8
9
10
11
{% mermaid %}
sequenceDiagram
Alice->>John: Hello John, how are you?
loop Healthcheck
John->>John: Fight against hypochondria
end
Note right of John: Rational thoughts!
John-->>Alice: Great!
John->>Bob: How about you?
Bob-->>John: Jolly good!
{% endmermaid %}

Demo-甘特图

1
2
3
4
5
6
7
8
9
10
{% mermaid %}
gantt
section Section
Completed :done, des1, 2014-01-06,2014-01-08
Active :active, des2, 2014-01-07, 3d
Parallel 1 : des3, after des1, 1d
Parallel 2 : des4, after des1, 1d
Parallel 3 : des5, after des3, 1d
Parallel 4 : des6, after des4, 1d
{% endmermaid %}

Demo-类图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{% mermaid %}
classDiagram
Class01 <|-- AveryLongClass : Cool
<<Interface>> Class01
Class09 --> C2 : Where am i?
Class09 --* C3
Class09 --|> Class07
Class07 : equals()
Class07 : Object[] elementData
Class01 : size()
Class01 : int chimp
Class01 : int gorilla
class Class10 {
<<service>>
int id
size()
}
{% endmermaid %}

Demo-状态图

1
2
3
4
5
6
7
8
9
{% mermaid %}
stateDiagram-v2
[*] --> Still
Still --> [*]
Still --> Moving
Moving --> Still
Moving --> Crash
Crash --> [*]
{% endmermaid %}

Demo-饼图

1
2
3
4
pie
"Dogs" : 386
"Cats" : 85
"Rats" : 15

Demo-Git图

1
2
3
4
5
6
7
8
9
10
11
{% mermaid %}
journey
title My working day
section Go to work
Make tea: 5: Me
Go upstairs: 3: Me
Do work: 1: Me, Cat
section Go home
Go downstairs: 5: Me
Sit down: 3: Me
{% endmermaid %}