目前未兼容最新版本,请移步步原教程:Akilarの外挂标签引入

行内文本样式 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
1. 带 {% u 下划线 %} 的文本
2. 带 {% emp 着重号 %} 的文本
3. 带 {% wavy 波浪线 %} 的文本
4. 带 {% del 删除线 %} 的文本
5. 键盘样式的文本 {% kbd command %} + {% kbd D %}
6. 密码样式的文本:{% psw 这里没有验证码 %}

行内文本 span

1
{% span 样式参数(参数以空格划分), 文本内容 %}
  1. 字体: logo, code
  2. 颜色:red,yellow,green,cyan,blue,gray
  3. 大小: small, h4, h3, h2, h1, large, huge, ultra
  4. 对齐方向: left, center, right
  • 彩色文字
    在一段话中方便插入各种颜色的标签,包括:红色黄色绿色青色蓝色灰色
  • 超大号文字
    文档「开始」页面中的标题部分就是超大号文字。

    A Wonderful Theme for Hexo
1
2
3
4
5
6
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:{% 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

1
{% p 样式参数(参数以空格划分), 文本内容 %}
  1. 字体: logo, code
  2. 颜色:red,yellow,green,cyan,blue,gray
  3. 大小: small, h4, h3, h2, h1, large, huge, ultra
  4. 对齐方向: left, center, right
  • 彩色文字
    在一段话中方便插入各种颜色的标签,包括:

    红色

    黄色

    绿色

    青色

    蓝色

    灰色

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

    A Wonderful Theme for Hexo

1
2
3
4
5
6
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:{% 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
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

Note标签外挂有两种用法。iconslight_bg_offset只对方法一生效。

方法一
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
style【可选】可以覆盖配置中的 style(simple/modern/flat/disabled)
方法二
参数用法
class【可选】标识,不同的标识有不同的配色( default / primary / success / info / warning / danger )
no-icon【可选】可配置自定义 icon (只支持 fontawesome 图标, 也可以配置 no-icon )
style【可选】可以覆盖配置中的 style(simple/modern/flat/disabled)
方法一
  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样式
    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 %}
  2. 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 %}
  3. 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 %}
  4. 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 %}
  5. 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 %}
  2. 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 %}
  3. 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 %}
  4. 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 %}
  5. 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,ban,home,sync,cogs,key,bell
  2. 自定义图标: 支持fontawesome。

默认情况

success

error

warning

bolt

ban

home

sync

cogs

key

bell

自定义font awesome图标

1
2
3
4
5
6
7
8
9
10
11
12
{% tip %}默认情况{% 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.js是我自己写的,所以我清楚它会怎么被渲染成html,才用的这个写法。可以熟读文档,使用html语言来编写其他标签类型。

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

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

  1. 将所需的CSS类添加到图标(或DOM中的任何元素)。
  2. 对于父级悬停样式,需要给目标元素添加指定CSS类,同时还要给目标元素的父级元素添加CSSfaa-parent animated-hover。(详情见示例及示例源码)You can regulate the speed of the animation by adding the CSS class or . faa-fastfaa-slow
  3. 可以通过给目标元素添加CSSfaa-fastfaa-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-flas
  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-shake animated   faa-shake animated-hover   faa-shake
  faa-pulse animated   faa-pulse animated-hover   faa-pulse
  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
  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
  1. On DOM load(当页面加载时显示动画)

    warning

    ban

  2. 调整动画速度

    warning

    ban

  3. On hover(当鼠标悬停时显示动画)

    warning

    ban

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

    warning

    ban

  1. On DOM load(当页面加载时显示动画)
    1
    2
    {% tip warning faa-horizontal animated %}warning{% endtip %}
    {% tip ban faa-flash animated %}ban{% endtip %}
  2. 调整动画速度
    1
    2
    {% tip warning faa-horizontal animated faa-fast %}warning{% endtip %}
    {% tip ban faa-flash animated faa-slow %}ban{% endtip %}
  3. On hover(当鼠标悬停时显示动画)
    1
    2
    {% tip warning faa-horizontal animated-hover %}warning{% endtip %}
    {% tip ban faa-flash animated-hover %}ban{% endtip %}
  4. 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) %}
  1. 样式: plus, minus, times
  2. 颜色:red,yellow,green,cyan,blue,gray
  3. 选中状态: checked

纯文本测试

支持简单的 markdown 语法

支持自定义颜色

绿色 + 默认选中

黄色 + 默认选中

青色 + 默认选中

蓝色 + 默认选中

增加

减少

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

1
{% radio 样式参数(可选), 文本(支持简单md) %}
  1. 颜色:red,yellow,green,cyan,blue,gray
  2. 选中状态: checked

纯文本测试

支持简单的 markdown 语法

支持自定义颜色

绿色

黄色

青色

蓝色

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

时间轴 timeline

1
2
3
4
5
6
7
8
{% timeline 时间线标题(可选)[,color] %}
<!-- timeline 时间节点(标题) -->
正文内容
<!-- endtimeline -->
<!-- timeline 时间节点(标题) -->
正文内容
<!-- endtimeline -->
{% endtimeline %}

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

时间轴样式

2020-07-24 2.6.6 -> 3.0

  1. 如果有 hexo-lazyload-image 插件,需要删除并重新安装最新版本,设置 lazyload.isSPA: true
  2. 2.x 版本的 css 和 js 不适用于 3.x 版本,如果使用了 use_cdn: true 则需要删除。
  3. 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。
  4. 2.x 版本的置顶 top: true 改为了 pin: true,并且同样适用于 layout: page 的页面。
  5. 如果使用了 hexo-offline 插件,建议卸载,3.0 版本默认开启了 pjax 服务。

2020-05-15 2.6.3 -> 2.6.6

不需要额外处理。

2020-04-20 2.6.2 -> 2.6.3

  1. 全局搜索 seotitle 并替换为 seo_title
  2. group 组件的索引规则有变,使用 group 组件的文章内,group: group_name 对应的组件名必须是 group_name
  3. group 组件的列表名优先显示文章的 short_title 其次是 title
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
{% timeline 时间轴样式,blue %}

<!-- timeline 2020-07-24 [2.6.6 -> 3.0](https://github.com/volantis-x/hexo-theme-volantis/releases) -->

1. 如果有 `hexo-lazyload-image` 插件,需要删除并重新安装最新版本,设置 `lazyload.isSPA: true`
2. 2.x 版本的 css 和 js 不适用于 3.x 版本,如果使用了 `use_cdn: true` 则需要删除。
3. 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。
4. 2.x 版本的置顶 `top: true` 改为了 `pin: true`,并且同样适用于 `layout: page` 的页面。
5. 如果使用了 `hexo-offline` 插件,建议卸载,3.0 版本默认开启了 pjax 服务。

<!-- endtimeline -->

<!-- timeline 2020-05-15 [2.6.3 -> 2.6.6](https://github.com/volantis-x/hexo-theme-volantis/releases/tag/2.6.6) -->

不需要额外处理。

<!-- endtimeline -->

<!-- timeline 2020-04-20 [2.6.2 -> 2.6.3](https://github.com/volantis-x/hexo-theme-volantis/releases/tag/2.6.3) -->

1. 全局搜索 `seotitle` 并替换为 `seo_title`
2. group 组件的索引规则有变,使用 group 组件的文章内,`group: group_name` 对应的组件名必须是 `group_name`
2. group 组件的列表名优先显示文章的 `short_title` 其次是 `title`

<!-- endtimeline -->

{% endtimeline %}

链接卡片 link

github卡片 ghcard

ghcard使用了github-readme-statsAPI,支持直接使用markdown语法来写。

1
2
{% ghcard 用户名, 其它参数(可选) %}
{% ghcard 用户名/仓库, 其它参数(可选) %}

更多参数可以参考:

使用,分割各个参数。写法为:参数名=参数值
以下只写几个常用参数值。

参数名 取值 释义
hide stars,commits,prs,issues,contribs 隐藏指定统计
count_private true 将私人项目贡献添加到总提交计数中
show_icons true 显示图标
theme 请查阅Available Themes 主题
  1. 用户信息卡片
  2. 仓库信息卡片
  1. 用户信息卡片
    1
    2
    3
    4
    5
    | {% ghcard xaoxuu %}                | {% ghcard xaoxuu, theme=vue %}             |
    | ---------------------------------- | ------------------------------------------ |
    | {% ghcard xaoxuu, theme=buefy %} | {% ghcard xaoxuu, theme=solarized-light %} |
    | {% ghcard xaoxuu, theme=onedark %} | {% ghcard xaoxuu, theme=solarized-dark %} |
    | {% ghcard xaoxuu, theme=algolia %} | {% ghcard xaoxuu, theme=calm %} |
  2. 仓库信息卡片
    1
    2
    3
    4
    5
    | {% ghcard volantis-x/hexo-theme-volantis %}                | {% ghcard volantis-x/hexo-theme-volantis, theme=vue %}             |
    | ---------------------------------------------------------- | ------------------------------------------------------------------ |
    | {% ghcard volantis-x/hexo-theme-volantis, theme=buefy %} | {% ghcard volantis-x/hexo-theme-volantis, theme=solarized-light %} |
    | {% ghcard volantis-x/hexo-theme-volantis, theme=onedark %} | {% ghcard volantis-x/hexo-theme-volantis, theme=solarized-dark %} |
    | {% ghcard volantis-x/hexo-theme-volantis, theme=algolia %} | {% ghcard volantis-x/hexo-theme-volantis, theme=calm %} |

github徽标 ghbdage

关于ghbdage参数的更多具体用法可以参看站内教程:添加github徽标

1
{% 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. 拓展参数

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

  1. 基本参数,定义徽标左右文字和图标
    1
    2
    {% bdage Theme,Butterfly %}
    {% bdage Frame,Hexo,hexo %}
  2. 信息参数,定义徽标右侧内容背景色,指向链接
    1
    2
    3
    {% bdage CDN,JsDelivr,jsDelivr||abcdef,https://metroui.org.ua/index.html,本站使用JsDelivr为静态资源提供CDN加速 %}
    //如果是跨顺序省略可选参数,仍然需要写个逗号,用作分割
    {% bdage Source,GitHub,GitHub||,https://github.com/ %}
  3. 拓展参数,支持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 %}

网站卡片 sites

1
2
3
4
{% sitegroup %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接(可选), description=描述(可选) %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接(可选), description=描述(可选) %}
{% endsitegroup %}
1
2
3
4
5
6
{% sitegroup %}
{% site Ethan.Tzy, url=https://fe32.top/, screenshot=https://bu.dusays.com/2022/06/01/6296ceb2e4935.jpg, avatar=https://bu.dusays.com/2022/05/02/626f92e193879.jpg, description=古今之成大事者,不惟有超世之才,亦必有坚忍不拔之志%}
{% site Ethan.Tzy, url=https://fe32.top/, screenshot=https://bu.dusays.com/2022/06/01/6296ceb2e4935.jpg, avatar=https://bu.dusays.com/2022/05/02/626f92e193879.jpg, description=古今之成大事者,不惟有超世之才,亦必有坚忍不拔之志%}
{% site Ethan.Tzy, url=https://fe32.top/, screenshot=https://bu.dusays.com/2022/06/01/6296ceb2e4935.jpg, avatar=https://bu.dusays.com/2022/05/02/626f92e193879.jpg, description=古今之成大事者,不惟有超世之才,亦必有坚忍不拔之志%}
{% site Ethan.Tzy, url=https://fe32.top/, screenshot=https://bu.dusays.com/2022/06/01/6296ceb2e4935.jpg, avatar=https://bu.dusays.com/2022/05/02/626f92e193879.jpg, description=古今之成大事者,不惟有超世之才,亦必有坚忍不拔之志%}
{% endsitegroup %}

行内图片 inlineimage

1
{% inlineimage 图片链接, height=高度(可选) %}
  1. 高度:height=20px

这是 一段话。

这又是 一段话。

1
2
3
这是 {% inlineimage https://bu.dusays.com/2022/05/19/628532706842d.gif %} 一段话。

这又是 {% inlineimage https://bu.dusays.com/2022/05/19/6285328a83ca7.gif, height=40px %} 一段话。

单张图片 image

1
{% image 链接, width=宽度(可选), height=高度(可选), alt=描述(可选), bg=占位颜色(可选) %}
  1. 图片宽度高度:width=300px, height=32px
  2. 图片描述:alt=图片描述(butterfly需要在主题配置文件中开启图片描述)
  3. 占位背景色:bg=#f2f2f2
  1. 添加描述:
    愿你成为自己的太阳,无需凭借谁的光芒。
    愿你成为自己的太阳,无需凭借谁的光芒。
  2. 指定宽度:
  3. 指定宽度并添加描述:
    愿你成为自己的太阳,无需凭借谁的光芒。
    愿你成为自己的太阳,无需凭借谁的光芒。
  4. 设置占位背景色:
    优化不同宽度浏览的观感
    优化不同宽度浏览的观感
  1. 添加描述:
    1
    {% image https://bu.dusays.com/2022/05/19/6285306c996c4.jpg, alt=愿你成为自己的太阳,无需凭借谁的光芒。 %}
  2. 指定宽度:
    1
    {% image https://bu.dusays.com/2022/05/19/6285306c996c4.jpg, width=400px %}
  3. 指定宽度并添加描述:
    1
    {% image https://bu.dusays.com/2022/05/19/6285306c996c4.jpg, width=400px, alt=愿你成为自己的太阳,无需凭借谁的光芒。 %}
  4. 设置占位背景色:
    1
    {% image https://bu.dusays.com/2022/05/19/6285306c996c4.jpg, width=400px, bg=#1D0C04, alt=优化不同宽度浏览的观感 %}

音频 audio

1
{% audio 音频链接 %}
1
{% audio https://github.com/volantis-x/volantis-docs/releases/download/assets/Lumia1020.mp3 %}

视频 video

1
{% video 视频链接 %}
  1. 对其方向:left, center, right
  2. 列数:逗号后面直接写列数,支持 1 ~ 4 列。
  1. 100%宽度
  2. 50%宽度
  3. 25%宽度
  1. 100%宽度
    1
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
  2. 50%宽度
    1
    2
    3
    4
    5
    6
    {% videos, 2 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% endvideos %}
  3. 25%宽度
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    {% videos, 4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% video https://txmov2.a.yximgs.com/upic/2022/11/13/21/BMjAyMjExMTMyMTQxNThfMjk1MTM4ODg1MV84ODY2ODQ2MzE3NV8wXzM=_b_B5980ab28f909cff50f35f4b4b1c8c298.mp4 %}
    {% endvideos %}

相册 gallery

Butterfly自带gallery相册,而且会根据图片大小自动调整排版,效果比Volantisgallery更好,故不再收录Volantisgallery标签。

以下为Butterfly自带的gallery标签写法。相册图库和相册配合使用。

折叠框 folding

1
2
3
{% folding 参数(可选), 标题 %}
![](https://bu.dusays.com/2022/05/19/628533399e7a1.jpg)
{% endfolding %}
  1. 颜色:blue, cyan, green, yellow, red
  2. 状态:状态填写 open 代表默认打开。
查看图片测试

查看默认打开的折叠框

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

查看代码测试

假装这里有代码块(代码块没法嵌套代码块)

查看列表测试
  • haha
  • hehe
查看嵌套测试
查看嵌套测试2
查看嵌套测试3

hahaha

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
{% folding 查看图片测试 %}

![](https://bu.dusays.com/2022/05/19/628533399e7a1.jpg)

{% 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://bu.dusays.com/2022/05/19/62853244cef33.png' style='height:24px'></span>

{% endfolding %}

{% endfolding %}

{% endfolding %}

分栏 tab

1
2
3
4
5
{% 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)。
    • 如果index为-1,则不会选择任何选项卡。
    • 可选参数
  3. [Tab caption]:
    • 当前选项卡的标题。
    • 如果未指定标题,则带有制表符索引后缀的唯一名称将用作制表符的标题。
    • 如果未指定标题,但指定了图标,则标题将为空。
    • 可选参数。
  4. [@icon]:
    • FontAwesome图标名称(全名,看起来像“ fas fa-font”)
    • 可以指定带空格或不带空格;
    • 例如’Tab caption @icon’ 和 ‘Tab caption@icon’.
    • 可选参数。

Demo 1 - 预设选择第一个【默认】

This is Tab 1.

This is Tab 2.

This is Tab 3.

Demo 2 - 预设选择tabs

This is Tab 1.

This is Tab 2.

This is Tab 3.

Demo 3 - 没有预设值

This is Tab 1.

This is Tab 2.

This is Tab 3.

Demo 4 - 自定义Tab名 + 只有icon + icon和Tab名

tab名字为第一个Tab

只有图标 没有Tab名字

名字+icon

Demo 1 - 预设选择第一个【默认】

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

Demo 2 - 预设选择tabs

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

<!-- tab -->
**This is Tab 2.**
<!-- endtab -->

<!-- tab -->
**This is Tab 3.**
<!-- endtab -->
{% endtabs %}

Demo 3 - 没有预设值

1
2
3
4
5
6
7
8
9
10
11
12
13
{% 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
12
13
{% tabs test4 %}
<!-- tab 第一个Tab -->
**tab名字为第一个Tab**
<!-- endtab -->

<!-- tab @fab fa-apple-pay -->
**只有图标 没有Tab名字**
<!-- endtab -->

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

诗词标签 poem

1
2
3
{% poem [title],[author] %}
诗词内容
{% endpoem %}
  1. title:诗词标题
  2. author:作者,可以不写
水调歌头
苏轼

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

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

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

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