标签外挂Plus

转载自：

Tag Plugins Plus

https://akilar.top/posts/615e2dec/

1. 安装插件,在博客根目录[Blogroot]下打开终端，运行以下指令：

   npm install hexo-butterfly-tag-plugins-plus --save

   考虑到hexo自带的markdown渲染插件hexo-renderer-marked与外挂标签语法的兼容性较差，建议您将其替换成hexo-renderer-kramed

   npm uninstall hexo-renderer-marked --save
   npm install hexo-renderer-kramed --save

2. 在站点配置文件_config.yml或者主题配置文件中添加

   # 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@1.0.17/lib/tag_plugins.css

3. 参数释义

参数	备选值/类型	释义
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

• 标签语法
• 样式预览
• 示例源码

{% u 文本内容 %}
{% emp 文本内容 %}
{% wavy 文本内容 %}
{% del 文本内容 %}
{% kbd 文本内容 %}
{% psw 文本内容 %}

1. 带 下划线 的文本
2. 带 着重号 的文本
3. 带 波浪线 的文本
4. 带 删除线 的文本
5. 键盘样式的文本 command + D
6. 密码样式的文本：这里没有验证码

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

行内文本 span

• 标签语法
• 配置参数
• 样式预览
• 示例源码

{% span 样式参数(参数以空格划分), 文本内容 %}

1. 字体: logo, code
2. 颜色: red,yellow,green,cyan,blue,gray
3. 大小: small, h4, h3, h2, h1, large, huge, ultra
4. 对齐方向: left, center, right

• 彩色文字
  在一段话中方便插入各种颜色的标签，包括：红色、黄色、绿色、青色、蓝色、灰色。
• 超大号文字
  文档「开始」页面中的标题部分就是超大号文字。
  Volantis
  A Wonderful Theme for Hexo

- 彩色文字
在一段话中方便插入各种颜色的标签，包括：{% span red, 红色 %}、{% span yellow, 黄色 %}、{% span green, 绿色 %}、{% span cyan, 青色 %}、{% span blue, 蓝色 %}、{% span gray, 灰色 %}。
- 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
{% span center logo large, Volantis %}
{% span center small, A Wonderful Theme for Hexo %}

段落文本 p

• 标签语法
• 配置参数
• 样式预览
• 示例源码

{% p 样式参数(参数以空格划分), 文本内容 %}

1. 字体: logo, code
2. 颜色: red,yellow,green,cyan,blue,gray
3. 大小: small, h4, h3, h2, h1, large, huge, ultra
4. 对齐方向: left, center, right

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

  红色

  、

  黄色

  、

  绿色

  、

  青色

  、

  蓝色

  、

  灰色

  。
• 超大号文字
  文档「开始」页面中的标题部分就是超大号文字。

  Volantis

  A Wonderful Theme for Hexo

- 彩色文字
在一段话中方便插入各种颜色的标签，包括：{% p red, 红色 %}、{% p yellow, 黄色 %}、{% p green, 绿色 %}、{% p cyan, 青色 %}、{% p blue, 蓝色 %}、{% p gray, 灰色 %}。
- 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
{% p center logo large, Volantis %}
{% p center small, A Wonderful Theme for Hexo %}

引用 note

以下是butterfly主题的note写法。

• 样式预览
• 示例源码

方法一

1. simple样式

   默认 提示块标签

   default 提示块标签

   primary 提示块标签

   success 提示块标签

   info 提示块标签

   warning 提示块标签

   danger 提示块标签

2. modern样式

   默认 提示块标签

   default 提示块标签

   primary 提示块标签

   success 提示块标签

   info 提示块标签

   warning 提示块标签

   danger 提示块标签

3. flat样式

   默认 提示块标签

   default 提示块标签

   primary 提示块标签

   success 提示块标签

   info 提示块标签

   warning 提示块标签

   danger 提示块标签

4. disabled样式

   默认 提示块标签

   default 提示块标签

   primary 提示块标签

   success 提示块标签

   info 提示块标签

   warning 提示块标签

   danger 提示块标签

5. no-icon样式

   默认 提示块标签

   default 提示块标签

   primary 提示块标签

   success 提示块标签

   info 提示块标签

   warning 提示块标签

   danger 提示块标签

方法二

1. simple样式

   你是刷 Visa 还是 UnionPay

   2021年快到了….

   小心开车 安全至上

   这是三片呢？还是四片？

   你是刷 Visa 还是 UnionPay

   剪刀石头布

   前端最讨厌的浏览器

2. modern样式

   你是刷 Visa 还是 UnionPay

   2021年快到了….

   小心开车 安全至上

   这是三片呢？还是四片？

   你是刷 Visa 还是 UnionPay

   剪刀石头布

   前端最讨厌的浏览器

3. flat样式

   你是刷 Visa 还是 UnionPay

   2021年快到了….

   小心开车 安全至上

   这是三片呢？还是四片？

   你是刷 Visa 还是 UnionPay

   剪刀石头布

   前端最讨厌的浏览器

4. disabled样式

   你是刷 Visa 还是 UnionPay

   2021年快到了….

   小心开车 安全至上

   这是三片呢？还是四片？

   你是刷 Visa 还是 UnionPay

   剪刀石头布

   前端最讨厌的浏览器

5. no-icon样式

   你是刷 Visa 还是 UnionPay

   2021年快到了….

   小心开车 安全至上

   这是三片呢？还是四片？

   你是刷 Visa 还是 UnionPay

   剪刀石头布

   前端最讨厌的浏览器

方法一

1. 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 %}

2. 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 %}

3. 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 %}

4. 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 %}

5. 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 %}

方法二

1. 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 %}

2. 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 %}

3. 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 %}

4. 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 %}

5. 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 %}

上标标签 tip

• 标签语法
• 配置参数
• 样式预览
• 示例源码

{% tip [参数，可选] %}文本内容{% endtip %}

1. 样式: success,error,warning,bolt,ban,home,sync,cogs,key,bell
2. 自定义图标: 支持fontawesome。

default

info

success

error

warning

bolt

ban

home

sync

cogs

key

bell

自定义font awesome图标

{% 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 cogs %}cogs{% endtip %}
{% tip key %}key{% endtip %}
{% tip bell %}bell{% endtip %}
{% tip fa-atom %}自定义font awesome图标{% endtip %}

动态标签 anima

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

• 标签语法
• 配置参数
• 样式预览
• 示例源码

{% tip [参数，可选] %}文本内容{% endtip %}

更多详情请参看font-awesome-animation文档

1. 将所需的CSS类添加到图标（或DOM中的任何元素）。
2. 对于父级悬停样式，需要给目标元素添加指定CSS类，同时还要给目标元素的父级元素添加CSS类faa-parent animated-hover。（详情见示例及示例源码）
   You can regulate the speed of the animation by adding the CSS class or . faa-fastfaa-slow
3. 可以通过给目标元素添加CSS类faa-fast或faa-slow来控制动画快慢。

On DOM load 当页面加载时 显示动画	On hover 当鼠标悬停时 显示动画	On parent hover 当鼠标悬停 在父级元素时 显示动画
faa-wrench animated	faa-wrench animated-hover	faa-wrench
faa-ring animated	faa-ring animated-hover	faa-ring
faa-horizontal animated	faa-horizontal animated-hover	faa-horizontal
faa-vertical animated	faa-vertical animated-hover	faa-vertical
faa-flash animated	faa-flash animated-hover	faa-flash
faa-bounce animated	faa-bounce animated-hover	faa-bounce
faa-spin animated	faa-spin animated-hover	faa-spin
faa-tada animated	faa-tada animated-hover	faa-tada
faa-pulse animated	faa-pulse animated-hover	faa-pulse
faa-shake animated	faa-shake animated-hover	faa-shake
faa-tada animated	faa-tada animated-hover	faa-tada
faa-passing animated	faa-passing animated-hover	faa-passing
faa-passing-reverse animated	faa-passing-reverse animated-hover	faa-passing-reverse
faa-burst animated	faa-burst animated-hover	faa-burst
faa-falling animated	faa-falling animated-hover	faa-falling
faa-rising animated	faa-rising animated-hover	faa-rising

1. On DOM load（当页面加载时显示动画）

   warning

   ban

2. 调整动画速度

   warning

   ban

3. On hover（当鼠标悬停时显示动画）

   warning

   ban

4. On parent hover（当鼠标悬停在父级元素时显示动画）

   warning

   ban

1. On DOM load（当页面加载时显示动画）

   {% tip warning faa-horizontal animated %}warning{% endtip %}
   {% tip ban faa-flash animated %}ban{% endtip %}

2. 调整动画速度

   {% tip warning faa-horizontal animated faa-fast %}warning{% endtip %}
   {% tip ban faa-flash animated faa-slow %}ban{% endtip %}

3. On hover（当鼠标悬停时显示动画）

   {% tip warning faa-horizontal animated-hover %}warning{% endtip %}
   {% tip ban faa-flash animated-hover %}ban{% endtip %}

4. On parent hover（当鼠标悬停在父级元素时显示动画）

   {% 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

• 标签语法
• 配置参数
• 样式预览
• 示例源码

{% checkbox 样式参数（可选）, 文本（支持简单md） %}

1. 样式: plus, minus, times
2. 颜色: red,yellow,green,cyan,blue,gray
3. 选中状态: checked

纯文本测试

支持简单的 markdown 语法

支持自定义颜色

绿色 + 默认选中

黄色 + 默认选中

青色 + 默认选中

蓝色 + 默认选中

增加

减少

叉

{% checkbox 纯文本测试 %}
{% checkbox checked, 支持简单的 [markdown](https://guides.github.com/features/mastering-markdown/) 语法 %}
{% checkbox red, 支持自定义颜色 %}
{% checkbox green checked, 绿色 + 默认选中 %}
{% checkbox yellow checked, 黄色 + 默认选中 %}
{% checkbox cyan checked, 青色 + 默认选中 %}
{% checkbox blue checked, 蓝色 + 默认选中 %}
{% checkbox plus green checked, 增加 %}
{% checkbox minus yellow checked, 减少 %}
{% checkbox times red checked, 叉 %}

单选列表 radio

• 标签语法
• 单选列表 2
• 样式预览
• 示例源码

{% radio 样式参数（可选）, 文本（支持简单md） %}

1. 颜色: red,yellow,green,cyan,blue,gray
2. 选中状态: checked

纯文本测试

支持简单的 markdown 语法

支持自定义颜色

绿色

黄色

青色

蓝色

{% radio 纯文本测试 %}
{% radio checked, 支持简单的 [markdown](https://guides.github.com/features/mastering-markdown/) 语法 %}
{% radio red, 支持自定义颜色 %}
{% radio green, 绿色 %}
{% radio yellow, 黄色 %}
{% radio cyan, 青色 %}
{% radio blue, 蓝色 %}

时间轴 timeline

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% timeline 时间线标题（可选）[,color] %}
<!-- timeline 时间节点（标题） -->
正文内容
<!-- endtimeline -->
<!-- timeline 时间节点（标题） -->
正文内容
<!-- endtimeline -->
{% endtimeline %}

参数	解释
title	标题/时间线
color	timeline颜色:default(留空) / blue / pink / red / purple / orange / green

时间轴样式

2020-05-15

内容1

2020-04-20

内容2

{% timeline 时间轴样式,blue %}

<!-- timeline 2020-05-15 [发发发] -->

内容1

<!-- endtimeline -->

<!-- timeline 2020-04-20 [水电费] -->

内容2

<!-- endtimeline -->

{% endtimeline %}

链接卡片 link

• 标签语法
• 样式预览
• 示例源码

{% link 标题, 链接, 图片链接（可选） %}

巾帆迢迢

https://sscarf.com/

{% link 巾帆迢迢, https://sscarf.com/,  https://sscarf.com/img/icons8-sailboat-96.png %}

按钮 btns

Volantis的按钮使用的是btn和btns标签。btns和butterfly的button不冲突，但是btn会被强制渲染，导致部分参数失效,而且btn的效果还是butterfly的button更好看些。所以只适配了btns。

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% btns 样式参数 %}
{% cell 标题, 链接, 图片或者图标 %}
{% cell 标题, 链接, 图片或者图标 %}
{% endbtns %}

1. 圆角样式：rounded, circle
2. 增加文字样式：可以在容器内增加 <b>标题</b>和<p>描述文字</p>
3. 布局方式：
   默认为自动宽度，适合视野内只有一两个的情况。

参数	含义
wide	宽一点的按钮
fill	填充布局，自动铺满至少一行，多了会换行
center	居中，按钮之间是固定间距
around	居中分散
grid2	等宽最多2列，屏幕变窄会适当减少列数
grid3	等宽最多3列，屏幕变窄会适当减少列数
grid4	等宽最多4列，屏幕变窄会适当减少列数
grid5	等宽最多5列，屏幕变窄会适当减少列数

1. 如果需要显示类似「团队成员」之类的一组含有头像的链接：

   围巾 围巾 围巾 围巾 围巾

2. 或者含有图标的按钮：

   下载源码 查看文档

3. 圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中

   心率管家

   专业版

   心率管家

   免费版

1. 如果需要显示类似「团队成员」之类的一组含有头像的链接：

   {% btns circle grid5 %}
   {% cell 围巾, https://sscarf.com, https://sscarf.com/img/avatar.jpg %}
   {% cell 围巾, https://sscarf.com, https://sscarf.com/img/avatar.jpg %}
   {% cell 围巾, https://sscarf.com, https://sscarf.com/img/avatar.jpg %}
   {% cell 围巾, https://sscarf.com, https://sscarf.com/img/avatar.jpg %}
   {% cell 围巾, https://sscarf.com, https://sscarf.com/img/avatar.jpg %}
   {% endbtns %}

2. 或者含有图标的按钮：

   {% btns rounded grid5 %}
   {% cell 下载源码, /, fas fa-download %}
   {% cell 查看文档, /, fas fa-book-open %}
   {% endbtns %}

3. 圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中

   {% btns circle center grid5 %}
   <a href='/'>
     <i class='fas fa-heartbeat'></i>
     <b>心率管家</b>
     {% p red, 专业版 %}
   </a>
   <a href='/'>
     <i class='fas fa-heartbeat'></i>
     <b>心率管家</b>
     {% p green, 免费版 %}
   </a>
   {% endbtns %}

github徽标 ghbdage

• 标签语法
• 配置参数
• 样式预览
• 示例源码

{% bdage [right],[left],[logo]||[color],[link],[title]||[option] %}

1. left：徽标左边的信息，必选参数。
2. right: 徽标右边的信息，必选参数，
3. logo：徽标图标，图标名称详见simpleicons，可选参数。
4. color：徽标右边的颜色，可选参数。
5. link：指向的链接，可选参数。
6. title：徽标的额外信息，可选参数。主要用于优化SEO，但object标签不会像a标签一样在鼠标悬停显示title信息。
7. option：自定义参数，支持shields.io的全部API参数支持，具体参数可以参看上文中的拓展写法示例。形式为name1=value2&name2=value2。

1. 基本参数,定义徽标左右文字和图标

2. 信息参数，定义徽标右侧内容背景色，指向链接

3. 拓展参数，支持shields的API的全部参数内容

本外挂标签的参数分为三组，用||分割

1. 基本参数,定义徽标左右文字和图标

   {% bdage Theme,Butterfly %}
   {% bdage Frame,Hexo,hexo %}

2. 信息参数，定义徽标右侧内容背景色，指向链接

   {% bdage CDN,JsDelivr,jsDelivr||abcdef,https://metroui.org.ua/index.html,本站使用JsDelivr为静态资源提供CDN加速 %}
   //如果是跨顺序省略可选参数，仍然需要写个逗号,用作分割
   {% bdage Source,GitHub,GitHub||,https://github.com/ %}

3. 拓展参数，支持shields的API的全部参数内容

   {% bdage Hosted,Vercel,Vercel||brightgreen,https://vercel.com/,本站采用双线部署，默认线路托管于Vercel||style=social&logoWidth=20 %}
   //如果是跨顺序省略可选参数组，仍然需要写双竖线||用作分割
   {% bdage Hosted,Vercel,Vercel||||style=social&logoWidth=20&logoColor=violet %}

网站卡片 sites

• 标签语法
• 样式预览
• 示例源码

{% sitegroup %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接（可选）, description=描述（可选） %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接（可选）, description=描述（可选） %}
{% endsitegroup %}

巾帆迢迢这是一段关于这个网站的描述文字

巾帆迢迢这是一段关于这个网站的描述文字

巾帆迢迢这是一段关于这个网站的描述文字

巾帆迢迢这是一段关于这个网站的描述文字

{% sitegroup %}
{% site 巾帆迢迢, url=https://sscarf.com, screenshot=https://scarf.oss-cn-beijing.aliyuncs.com/img/4F88B40A4551D1E26167EE1847F70F50.jpg, avatar=https://sscarf.com/img/icons8-sailboat-96.png, description=这是一段关于这个网站的描述文字 %}
{% site 巾帆迢迢, url=https://sscarf.com, screenshot=https://scarf.oss-cn-beijing.aliyuncs.com/img/4F88B40A4551D1E26167EE1847F70F50.jpg, avatar=https://sscarf.com/img/icons8-sailboat-96.png, description=这是一段关于这个网站的描述文字 %}
{% site 巾帆迢迢, url=https://sscarf.com, screenshot=https://scarf.oss-cn-beijing.aliyuncs.com/img/4F88B40A4551D1E26167EE1847F70F50.jpg, avatar=https://sscarf.com/img/icons8-sailboat-96.png, description=这是一段关于这个网站的描述文字 %}
{% site 巾帆迢迢, url=https://sscarf.com, screenshot=https://scarf.oss-cn-beijing.aliyuncs.com/img/4F88B40A4551D1E26167EE1847F70F50.jpg, avatar=https://sscarf.com/img/icons8-sailboat-96.png, description=这是一段关于这个网站的描述文字 %}
{% endsitegroup %}

行内图片 inlineimage

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% inlineimage 图片链接, height=高度（可选） %}

1. 高度：height=20px

这是 一段话。

这又是 一段话。

这是 {% inlineimage https://sscarf.com/img/21.webp %} 一段话。

这又是 {% inlineimage https://sscarf.com/img/21.webp, height=40px %} 一段话。

单张图片 image

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% image 链接, width=宽度（可选）, height=高度（可选）, alt=描述（可选）, bg=占位颜色（可选） %}

1. 图片宽度高度：width=300px, height=32px
2. 图片描述：alt=图片描述（butterfly需要在主题配置文件中开启图片描述）
3. 占位背景色：bg=#f2f2f2

1. 添加描述：

   

   每天下课回宿舍的路，没有什么故事。

2. 指定宽度：

   

3. 指定宽度并添加描述：

   

   每天下课回宿舍的路，没有什么故事。

4. 设置占位背景色：

   

   优化不同宽度浏览的观感

1. 添加描述：

   {% image https://sscarf.com/img/21.webp, alt=每天下课回宿舍的路，没有什么故事。 %}

2. 指定宽度：

   {% image https://sscarf.com/img/21.webp, width=400px %}

3. 指定宽度并添加描述：

   {% image https://sscarf.com/img/21.webp, width=400px, alt=每天下课回宿舍的路，没有什么故事。 %}

4. 设置占位背景色：

   {% image https://sscarf.com/img/21.webp, width=400px, bg=#1D0C04, alt=优化不同宽度浏览的观感 %}

音频 audio

• 标签语法
• 样式预览
• 示例源码

{% audio 音频链接 %}

{% audio https://sscarf.com/.. %}

视频 video

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% video 视频链接 %}

1. 对其方向：left, center, right
2. 列数：逗号后面直接写列数，支持 1 ～ 4 列。

1. 100%宽度

2. 50%宽度

3. 25%宽度

1. 100%宽度

   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}

2. 50%宽度

   {% videos, 2 %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% endvideos %}

3. 25%宽度

   {% videos, 4 %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% video https://github.com/volantis-x/volantis-docs/releases/download/assets/IMG_0341.mov %}
   {% endvideos %}

相册 gallery

Hexo+Butterfly主题配置

https://sscarf.com/posts/56977.html

折叠框 folding

Butterfly虽然也有内置折叠框hideToggle标签，但是Volantis的folding折叠框更好看一些。

• 标签语法
• 配置参数
• 样式预览
• 示例源码

{% folding 参数（可选）, 标题 %}
![](https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/41F215B9-261F-48B4-80B5-4E86E165259E.jpeg)
{% endfolding %}

1. 颜色：blue, cyan, green, yellow, red
2. 状态：状态填写 open 代表默认打开。

查看图片测试

查看默认打开的折叠框

这是一个默认打开的折叠框。

查看代码测试

假装这里有代码块（代码块没法嵌套代码块）

查看列表测试

• haha
• hehe

查看嵌套测试

查看嵌套测试2

查看嵌套测试3

hahaha

{% folding 查看图片测试 %}

![](https://scarf.oss-cn-beijing.aliyuncs.com/img/twikoo_bg.png)

{% endfolding %}

{% folding cyan open, 查看默认打开的折叠框 %}

这是一个默认打开的折叠框。

{% endfolding %}

{% folding green, 查看代码测试 %}
假装这里有代码块（代码块没法嵌套代码块）
{% endfolding %}

{% folding yellow, 查看列表测试 %}

- haha
- hehe

{% endfolding %}

{% folding red, 查看嵌套测试 %}

{% folding blue, 查看嵌套测试2 %}

{% folding 查看嵌套测试3 %}

hahaha <span><img src='https://scarf.oss-cn-beijing.aliyuncs.com/img/twikoo_bg.png' style='height:24px'></span>

{% endfolding %}

{% endfolding %}

{% endfolding %}

分栏 tab

Hexo+Butterfly主题配置

https://sscarf.com/posts/56977.html

诗词标签 poem

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% poem [title],[author] %}
诗词内容
{% endpoem %}

1. title：诗词标题
2. author：作者，可以不写

水调歌头

苏轼

丙辰中秋，欢饮达旦，大醉，作此篇，兼怀子由。
明月几时有？把酒问青天。
不知天上宫阙，今夕是何年？
我欲乘风归去，又恐琼楼玉宇，高处不胜寒。
起舞弄清影，何似在人间？

转朱阁，低绮户，照无眠。
不应有恨，何事长向别时圆？
人有悲欢离合，月有阴晴圆缺，此事古难全。
但愿人长久，千里共婵娟。

{% poem 水调歌头,苏轼 %}
丙辰中秋，欢饮达旦，大醉，作此篇，兼怀子由。
明月几时有？把酒问青天。
不知天上宫阙，今夕是何年？
我欲乘风归去，又恐琼楼玉宇，高处不胜寒。
起舞弄清影，何似在人间？

转朱阁，低绮户，照无眠。
不应有恨，何事长向别时圆？
人有悲欢离合，月有阴晴圆缺，此事古难全。
但愿人长久，千里共婵娟。
{% endpoem %}

阿里图标 icon

引入阿里图标矢量库

https://sscarf.com/posts/17889.html

进度条 progress

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% progress [width] [color] [text] %}

width: 0到100的阿拉伯数字
color: 颜色，取值有red,yellow,green,cyan,blue,gray
text:进度条上的文字内容

进度条样式预览

进度条样式预览

进度条样式预览

进度条样式预览

进度条样式预览

进度条样式预览

{% progress 10 red 进度条样式预览 %}
{% progress 30 yellow 进度条样式预览 %}
{% progress 50 green 进度条样式预览 %}
{% progress 70 cyan 进度条样式预览 %}
{% progress 90 blue 进度条样式预览 %}
{% progress 100 gray 进度条样式预览 %}

注释 notation

• 标签语法
• 参数配置
• 样式预览
• 示例源码

{% nota [label] , [text] %}

label: 注释词汇
text: 悬停显示的注解内容

把鼠标移动到我上面试试

{% nota 把鼠标移动到我上面试试 ,可以看到注解内容出现在顶栏 %}