标签语法 配置参数 样式预览/源码
1 2 3 4 5 {% tabs Unique name, [index] %} <!-- tab [Tab caption] [@icon] --> Any content (support inline tags too). <!-- endtab --> {% endtabs %}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 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.
源码
1 2 3 4 5 6 7 8 9 10 11 12 13 {% tabs test1 %} <!-- tab --> **This is Tab 1.** <!-- endtab --> <!-- tab --> **This is Tab 2.** <!-- endtab --> <!-- tab --> **This is Tab 3.** <!-- endtab --> {% endtabs %}
1.Note (Bootstrap Callout)
提示
配置 用法1 用法2(自定义icon)
修改 _config.butterfly.yml
1 2 3 4 5 6 7 8 9 10 11 12 13 # 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: flat icons: true 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
生效。
1 2 3 {% note [class] [no-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)
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 > simple {% 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 %}
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 28 29 > modern {% 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 %}
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 28 29 > flat {% 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 %}
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 29 > disabled {% 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 %}
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 28 29 > no-icon {% 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 %}
no-icon
1 2 3 {% note [color] [icon] [style] %} Any content (support inline tags too.io). {% endnote %}
color
【可选】顔色 ( default / blue / pink
/ red / purple / orange / green )
icon/no-icon
【可选】可配置自定义 icon (只支持
fontawesome 图标, 也可以配置 no-icon )
style
【可选】可以覆盖配置中的
style (simple/modern/flat/disabled)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 > simple {% 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 %}
simple
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 > modern {% 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 %}
modern
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 > flat {% 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 %}
flat
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 > disabled {% 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 %}
disabled
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 > no-icon {% 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 %}
no-icon
Inline
预览 源码
This is my website, click the button
Butterfly
This is my website, click the button
Butterfly
1 2 This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly %} This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,,outline%}
Block
预览 源码
This is my website, click the button
Butterfly
This is my website, click the button
Butterfly
This is my website, click the button
Butterfly
1 2 3 This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,block larger %} This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,block center larger %} This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,block right blue larger %}
Option
预览 源码
more than one button in center
1 2 3 4 5 6 7 8 9 <div class ="btn-center" > {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,blue larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,pink larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,red larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,purple larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,orange larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,green larger %} </div >
预览 源码
1 2 3 4 5 6 7 {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,outline larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,outline blue larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,outline pink larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,outline red larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,outline purple larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,outline orange larger %} {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,outline green larger %}
3.mermaid 绘图
修改 _config.butterfly.yml
1 2 3 4 5 6 7 8 # 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 %}
pie
title Key elements in Product X
"Calcium" : 42.96
"Potassium" : 50.05
"Magnesium" : 10.01
"Iron" : 5
1 2 3 4 5 6 7 8 {% mermaid %} pie title Key elements in Product X "Calcium" : 42.96 "Potassium" : 50.05 "Magnesium" : 10.01 "Iron" : 5 {% endmermaid %}
4.tag-hide 隐藏文字
inline block toggle
inline
在句中添加按钮隐藏内容,仅限隐藏文字。
(content
不能包含英文逗号,可用‚
)
1 {% hideInline content,display,bg,color %}
content:隐藏的文本内容
display:按钮的显示文字(可选)
bg:按钮的背景颜色(可选)
color:按钮的文字颜色(可选)
Demo
1 2 3 哪个英文字母最酷? {% hideInline 因为西装裤(C装酷),查看答案,#FF7242,#fff %} 门里站着一个人? {% hideInline 闪 %}
哪个英文字母最酷? 查看答案
因为西装裤(C装酷)
门里站着一个人? Click
闪
block
可以隐藏很多内容,包括图片、代码块等。
(display
不能包含英文逗号,可用‚
)
1 2 3 {% hideBlock display,bg,color %} content {% endhideBlock %}
content:隐藏的文本内容
display:按钮的显示文字(可选)
bg:按钮的背景颜色(可选)
color:按钮的文字颜色(可选)
Demo
1 2 3 4 查看答案 {% hideBlock 查看答案 %} 傻子,怎么可能有答案 {% endhideBlock %}
查看答案
如果你需要展示的内容太多,可以把它隐藏在收缩框里,需要时再把它展开。
(display
不能包含英文逗号,可用‚
)
1 2 3 {% hideToggle display,bg,color %} content {% endhideToggle %}
content:隐藏的文本内容
display:按钮的显示文字(可选)
bg:按钮的背景颜色(可选)
color:按钮的文字颜色(可选)
Demo
1 2 3 4 5 6 7 8 9 10 {% hideToggle Butterfly安装方法 %} 在你的博客根目录里 git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly 如果想要安装比较新的dev分支,可以 git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly {% endhideToggle %}
Butterfly安装方法
在你的博客根目录里
git clone -b master
https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly
如果想要安装比较新的dev分支,可以
git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git
themes/Butterfly
5.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:图库封面
壁纸
收藏的一些壁纸
漫威
关于漫威的图片
OH MY GIRL
关于OH MY GIRL的图片
1 2 3 4 5 <div class ="gallery-group-main" > {% galleryGroup '壁纸' '收藏的一些壁纸' '/Gallery/wallpaper' https://i.loli.net/2019/11/10/T7Mu8Aod3egmC4Q.png %} {% galleryGroup '漫威' '关于漫威的图片' '/Gallery/marvel' https://i.loli.net/2019/12/25/8t97aVlp4hgyBGu.jpg %} {% galleryGroup 'OH MY GIRL' '关于OH MY GIRL的图片' '/Gallery/ohmygirl' https://i.loli.net/2019/12/25/hOqbQ3BIwa6KWpo.jpg %} </div >
6.Gallery相册
本地
标签语法
样式预览
示例代码
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 {% gallery [lazyload],[rowHeight],[limit] %} markdown 图片格式 {% endgallery %} {% gallery %} markdown 图片格式 {% endgallery %} {% gallery true,220,10 %} markdown 图片格式 {% endgallery %} {% gallery true,,10 %} markdown 图片格式 {% endgallery %}
lazyload
【可选】点击按钮加载更多图片,填写 true/false
。默认为
false
。
rowHeight
【可选】图片显示的高度,如果需要一行显示更多的图片,可设置更小的数字。默认为
220
。
limit
【可选】每次加载多少张照片。默认为 10
。
1 2 3 4 5 6 7 8 9 10 {% gallery %} ![](https://i.loli.net/2019/12/25/Fze9jchtnyJXMHN.jpg ) ![](https://i.loli.net/2019/12/25/ryLVePaqkYm4TEK.jpg ) ![](https://i.loli.net/2019/12/25/gEy5Zc1Ai6VuO4N.jpg ) ![](https://i.loli.net/2019/12/25/d6QHbytlSYO4FBG.jpg ) ![](https://i.loli.net/2019/12/25/6nepIJ1xTgufatZ.jpg ) ![](https://i.loli.net/2019/12/25/E7Jvr4eIPwUNmzq.jpg ) ![](https://i.loli.net/2019/12/25/mh19anwBSWIkGlH.jpg ) ![](https://i.loli.net/2019/12/25/2tu9JC8ewpBFagv.jpg ) {% endgallery %}
[{"url":"https://i.loli.net/2019/12/25/Fze9jchtnyJXMHN.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/ryLVePaqkYm4TEK.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/gEy5Zc1Ai6VuO4N.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/d6QHbytlSYO4FBG.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/6nepIJ1xTgufatZ.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/E7Jvr4eIPwUNmzq.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/mh19anwBSWIkGlH.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/2tu9JC8ewpBFagv.jpg","alt":""}]
远程拉取
标签语法
样式预览
示例代码
1 2 {% gallery url,[link],[lazyload],[rowHeight],[limit] %} {% endgallery %}
url
【必须】 识别词
link
【必须】远程的 json 链接
lazyload
【可选】点击按钮加载更多图片,填写 true/false
。默认为
false
。
rowHeight
【可选】图片显示的高度,如果需要一行显示更多的图片,可设置更小的数字。默认为
220
。
limit
【可选】每次加载多少张照片。默认为 10
。
远程链接Json的例子
有三个参数,url
是必须存在的,alt
和
title
可有,也可没有。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 [ { "url" : "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0556.jpg" , "alt" : "IMG_0556.jpg" , "title" : "这是title" } , { "url" : "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0472.jpg" , "alt" : "IMG_0472.jpg" } , { "url" : "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0453.jpg" , "alt" : "" } , { "url" : "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0931.jpg" , "alt" : "" } ]
1 2 3 4 5 6 7 8 {% gallery url,https://xxxx.com/sss.json %} {% endgallery %} {% gallery url,https://xxxx.com/sss.json,true,220,10 %} {% endgallery %} {% gallery url,https://xxxx.com/sss.json,true,,10 %} {% endgallery %}
7.将代码部署到本地预览(Hexo二连)
1 2 3 4 5 6 7 // Git BASH终端 hexo cl && hexo s // 或者 // VSCODE终端 hexo cl; hexo s
8.将代码部署到Github(Hexo三连)
1 2 3 4 5 6 7 // Git BASH终端 hexo clean && hexo generate && hexo deploy // 或者 // VSCODE终端 hexo cl; hexo g; hexo d
9.新建文章
10.新建页面