主题标签 Tag Plugins

本文转载自 安知鱼主题标签 Tag Plugins

段落文本 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 %}

行内文本 span

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

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

- 彩色文字
  在一段话中方便插入各种颜色的标签，包括：{% 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 %}

行内文本样式 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 这里没有验证码 %}

分栏 tab

分栏支持内置阿里图标，如果开启了 fontawesome 可以使用 fontawesome 的图标，否则只能使用默内置阿里图标

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

{% 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 - 预设选择第一个【默认】

test1 1test1 2test1 3

This is Tab 1.

This is Tab 2.

This is Tab 3.

Demo 2 - 预设选择 tabs

test2 1test2 2test2 3

This is Tab 1.

This is Tab 2.

This is Tab 3.

Demo 3 - 没有预设值

test3 1test3 2test3 3

This is Tab 1.

This is Tab 2.

This is Tab 3.

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

第一个Tab炸弹

tab 名字为第一个 Tab

只有图标 没有 Tab 名字

名字+icon

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

{% tabs test1 %}

<!-- tab -->

**This is Tab 1.**

<!-- endtab -->

<!-- tab -->

**This is Tab 2.**

<!-- endtab -->

<!-- tab -->

**This is Tab 3.**

<!-- endtab -->

{% endtabs %}

Demo 2 - 预设选择 tabs

{% tabs test2, 3 %}

<!-- tab -->

**This is Tab 1.**

<!-- endtab -->

<!-- tab -->

**This is Tab 2.**

<!-- endtab -->

<!-- tab -->

**This is Tab 3.**

<!-- endtab -->

{% endtabs %}

Demo 3 - 没有预设值

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

{% tabs test4 %}

<!-- tab 第一个Tab -->

**tab 名字为第一个 Tab**

<!-- endtab -->

<!-- tab @fas fa-apple-alt -->

**只有图标 没有 Tab 名字**

<!-- endtab -->

<!-- tab 炸弹@fas fa-bomb -->

**名字+icon**

<!-- endtab -->

{% endtabs %}

按钮 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. 如果需要显示类似「团队成员」之类的一组含有头像的链接：

Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog

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

下载源码 查看文档

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

心率管家

专业版

心率管家

免费版

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

   {% btns circle grid5 %}
   {% cell Sukap's Blog, https://blog.sukap.cn, https://cos.sukap.cn/favicon.ico %}
   {% cell Sukap's Blog, https://blog.sukap.cn, https://cos.sukap.cn/favicon.ico %}
   {% cell Sukap's Blog, https://blog.sukap.cn, https://cos.sukap.cn/favicon.ico %}
   {% cell Sukap's Blog, https://blog.sukap.cn, https://cos.sukap.cn/favicon.ico %}
   {% cell Sukap's Blog, https://blog.sukap.cn, https://cos.sukap.cn/favicon.ico %}
   {% endbtns %}

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

   {% btns rounded grid5 %}
   {% cell 下载源码, /, anzhiyufont anzhiyu-icon-bolt %}
   {% cell 查看文档, /, anzhiyufont anzhiyu-icon-book %}
   {% endbtns %}

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

   {% btns circle center grid5 %}
   <a href='https://apps.apple.com/cn/app/heart-mate-pro-hrm-utility/id1463348922?ls=1' class="no-text-decoration">
   <i class='anzhiyufont anzhiyu-icon-heartbeat'></i>
   <b>心率管家</b>
   {% p red, 专业版 %}
   <img src='https://bu.dusays.com/2023/06/01/64787e2a1347c.png'>
   </a>
   <a href='https://apps.apple.com/cn/app/heart-mate-lite-hrm-utility/id1475747930?ls=1' class="no-text-decoration">
   <i class='anzhiyufont anzhiyu-icon-heartbeat'></i>
   <b>心率管家</b>
   {% p green, 免费版 %}
   <img src='https://bu.dusays.com/2023/06/01/64787e515e261.png'>
   </a>
   {% endbtns %}

按钮 btn

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

{% 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/留空

参数	含义
url	链接
text	按钮文字
icon	[可选] 图标，如果开启了 fontawesome 可以使用 fontawesome 的图标，否则只能使用默内置图标
color	[可选] 按钮背景顔色(默认 style 时）按钮字体和边框顔色(outline 时)default/blue/pink/red/purple/orange/green
style	[可选] 按钮样式 默认实心数，outline/留空
layout	[可选] 按钮佈局 默认为 line block/留空
position	[可选] 按钮位置 前提是设置了 layout 为 block 默认为左边 center/right/留空数
size	[可选] 按钮大小 larger/留空

1. 一组按钮

This is my website, click the button Sukap’s Blog
This is my website, click the button Sukap’s Blog
This is my website, click the button Sukap’s Blog
This is my website, click the button Sukap’s Blog
This is my website, click the button Sukap’s Blog

2. 调整位置/大小

Sukap’s Blog
Sukap’s Blog
Sukap’s Blog

3. 多按钮居中

Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog

4. 居中按钮

Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog Sukap's Blog

1. 一组按钮

This is my website, click the button {% btn 'https://blog.sukap.cn/',Sukap's Blog %}
This is my website, click the button {% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right %}
This is my website, click the button {% btn 'https://blog.sukap.cn/',Sukap's Blog,,outline %}
This is my website, click the button {% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline %}
This is my website, click the button {% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,larger %}

2. 调整位置/大小

{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,block %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,block center larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,block right outline larger %}

3. 多按钮居中

<span>
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,blue larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,pink larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,red larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,purple larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,orange larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,green larger %}
</span>

4. 居中按钮

<div class="btn-center">
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline blue larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline pink larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline red larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline purple larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline orange larger %}
{% btn 'https://blog.sukap.cn/',Sukap's Blog,anzhiyufont anzhiyu-icon-circle-arrow-right,outline green larger %}
</div>

网站卡片 sites

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

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

xaoxuu

Colsrch

Linhk1606

{% sitegroup %}
{% site xaoxuu, url=https://xaoxuu.com, screenshot=https://bu.dusays.com/2023/06/01/6478965ce6557.webp, avatar=https://cdn1.tianli0.top/gh/xaoxuu/cdn-assets/avatar/avatar.png, description=简约风格 %}
{% site Colsrch, url=https://colsrch.top, screenshot=https://i.loli.net/2020/08/22/dFRWXm52OVu8qfK.png, avatar=https://cdn1.tianli0.top/gh/Colsrch/images/Colsrch/avatar.jpg, description=这是一段关于这个网站的描述文字 %}
{% site Linhk1606, url=https://linhk1606.github.io, screenshot=https://bu.dusays.com/2023/06/01/6478963584621.png, avatar=https://bu.dusays.com/2023/06/01/6478968743368.png, description=这是一段关于这个网站的描述文字 %}
{% endsitegroup %}

单张图片 image

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

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

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

1. 添加描述
   

   每天下课回宿舍的路，没有什么故事。
2. 指定宽度：
   
3. 指定宽度并添加描述：
   

   每天下课回宿舍的路，没有什么故事。
4. 设置占位背景色：
   

   优化不同宽度浏览的观感

1. 添加描述

   {% image https://cos.sukap.cn/banner/1.jpg, alt=每天下课回宿舍的路，没有什么故事。 %}

2. 指定宽度：

   {% image https://cos.sukap.cn/banner/1.jpg, width=400px %}

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

   {% image https://cos.sukap.cn/banner/1.jpg, width=400px, alt=每天下课回宿舍的路，没有什么故事。 %}

4. 设置占位背景色：

   {% image https://cos.sukap.cn/banner/1.jpg, width=400px, bg=#1D0C04, alt=优化不同宽度浏览的观感 %}

inlineImg 行内图片

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

{% inlineImg [src] [height] %}

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

参数	含义
src	图片链接
height	【可选】图片高度限制

你看我长得漂亮不

我觉得很漂亮

你看我长得漂亮不

![](https://i.loli.net/2021/03/19/2P6ivUGsdaEXSFI.png)

我觉得很漂亮 {% inlineImg https://i.loli.net/2021/03/19/5M4jUB3ynq7ePgw.png 150px %}

行内图片 inlineimage

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

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

• 高度：height=20px

这是 一段话。

这又是 一段话。

这是 {% inlineimage https://bu.dusays.com/2023/06/01/647895232e5d5.webp %} 一段话。

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

label 标签

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

{% label text color %}

参数	含义
text	文字
color	【可选】背景颜色，默认为 default，default/blue/pink/red/purple/orange/green

臣亮言：先帝 创业未半，而中道崩殂 。今天下三分，益州疲敝 ，此诚危急存亡之秋 也！然侍衞之臣，不懈于内；忠志之士 ，忘身于外者，盖追先帝之殊遇，欲报之于陛下也。诚宜开张圣听，以光先帝遗德，恢弘志士之气；不宜妄自菲薄，引喻失义，以塞忠谏之路也。
宫中、府中，俱为一体；陟罚臧否，不宜异同。若有作奸 、犯科 ，及为忠善者，宜付有司，论其刑赏，以昭陛下平明之治；不宜偏私，使内外异法也。

臣亮言：{% label 先帝 %}创业未半，而{% label 中道崩殂 blue %}。今天下三分，{% label 益州疲敝 pink %}，此诚{% label 危急存亡之秋 red %}也！然侍衞之臣，不懈于内；{% label 忠志之士 purple %}，忘身于外者，盖追先帝之殊遇，欲报之于陛下也。诚宜开张圣听，以光先帝遗德，恢弘志士之气；不宜妄自菲薄，引喻失义，以塞忠谏之路也。
宫中、府中，俱为一体；陟罚臧否，不宜异同。若有{% label 作奸 orange %}、{% label 犯科 green %}，及为忠善者，宜付有司，论其刑赏，以昭陛下平明之治；不宜偏私，使内外异法也。

时间线 timeline

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

{% timeline title,color %}

<!-- timeline title -->

xxxxx

<!-- endtimeline -->
<!-- timeline title -->

xxxxx

<!-- endtimeline -->

{% endtimeline %}

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

1. 默认颜色

2022

01-02

这是测试页面

2. blue

2022

01-02

这是测试页面

3. pink

2022

01-02

这是测试页面

4. red

2022

01-02

这是测试页面

5. purple

2022

01-02

这是测试页面

6. orange

2022

01-02

这是测试页面

7. green

2022

01-02

这是测试页面

1. 默认颜色

{% timeline 2022 %}
<!-- timeline 01-02 -->

这是测试页面
<!-- endtimeline -->

{% endtimeline %}

2. blue

{% timeline 2022,blue %}
<!-- timeline 01-02 -->

这是测试页面
<!-- endtimeline -->

{% endtimeline %}

3. pink

{% timeline 2022,pink %}
<!-- timeline 01-02 -->

这是测试页面
<!-- endtimeline -->

{% endtimeline %}

4. red

{% timeline 2022,red %}
<!-- timeline 01-02 -->

这是测试页面
<!-- endtimeline -->

{% endtimeline %}

5. purple

{% timeline 2022,purple %}
<!-- timeline 01-02 -->

这是测试页面
<!-- endtimeline -->

{% endtimeline %}

6. orange

{% timeline 2022,orange %}
<!-- timeline 01-02 -->

这是测试页面
<!-- endtimeline -->

{% endtimeline %}

7. green

{% timeline 2022,orange %}
<!-- timeline 01-02 -->

这是测试页面
<!-- endtimeline -->

{% endtimeline %}

flink 友链标签

可在任何界面插入类似友情链接列表效果，内容格式与友情链接界面一样，支持 yml 格式，注意yml数据具有格式要求，请注意格式对齐，防止被编辑器格式化导致格式错误从而报错。

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

{% flink %}
xxxxxx
{% endflink %}

参数	含义
class_name	h2标题
flink_style	【可选】友链样式，默认为 flexcard，flexcard/anzhiyu
link_list	【可选】友链样式，默认为 flexcard，flexcard/anzhiyu

推荐博客

Sukap's Blog

网站

值得推荐的网站

Youtube

视频网站

Weibo

中国最大社交分享平台

Twitter

社交分享平台

{% flink %}
- class_name: 推荐博客
  flink_style: flexcard
  link_list:
    - name: Sukap's Blog
      link: https://blog.sukap.cn/
      avatar: https://q1.qlogo.cn/g?b=qq&nk=2576206327&s=640
      descr: 呓语红尘，一梦千朝✨
      siteshot: https://cos.sukap.cn/banner/2.jpg

- class_name: 网站
  class_desc: 值得推荐的网站
  flink_style: anzhiyu
  link_list:
    - name: Youtube
      link: https://www.youtube.com/
      avatar: https://i.loli.net/2020/05/14/9ZkGg8v3azHJfM1.png
      descr: 视频网站
    - name: Weibo
      link: https://www.weibo.com/
      avatar: https://i.loli.net/2020/05/14/TLJBum386vcnI1P.png
      descr: 中国最大社交分享平台
    - name: Twitter
      link: https://twitter.com/
      avatar: https://i.loli.net/2020/05/14/5VyHPQqR6LWF39a.png
      descr: 社交分享平台
{% endflink %}

mermaid 图

使用mermaid标签可以绘制Flowchart（流程图）、Sequence diagram（时序图 ）、Class Diagram（类别图）、State Diagram（状态图）、Gantt（甘特图）和Pie Chart（圆形图），具体可以查看mermaid文档

修改 主题配置文件

# mermaid
# see https://github.com/mermaid-js/mermaid
mermaid:
  enable: true
  # built-in themes: default/forest/dark/neutral
  theme:
    light: default
    dark: dark

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

{% mermaid %}
内容
{% endmermaid %}

{% mermaid %}
pie
    title Key elements in Product X
    "Calcium" : 42.96
    "Potassium" : 50.05
    "Magnesium" : 10.01
    "Iron" :  5
{% endmermaid %}

复选框 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, 叉 %}

dogeplayer 多吉云播放器

快捷引入 多吉云视频

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

{% dogeplayer userId vcode %}

获取userId与vcode

参数	含义
userId	多吉云userId
vcode	视频vcode

{% dogeplayer 4945 ebb742fd1f0b5a7b %}

折叠框 folding

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

{% folding 参数（可选）, 标题 %}
![](https://cos.sukap.cn/banner/1.jpg)
{% endfolding %}

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

查看图片测试

查看默认打开的折叠框

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

查看代码测试

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

查看列表测试

• haha
• hehe

查看嵌套测试

查看嵌套测试2

查看嵌套测试3

hahaha

{% folding 查看图片测试 %}

![](https://cos.sukap.cn/banner/1.jpg)

{% endfolding %}

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

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

{% endfolding %}

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

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

- haha
- hehe

{% endfolding %}

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

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

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

hahaha <span><img src='https://bu.dusays.com/2023/06/01/64788cd5a356b.png' style='height:24px'></span>

{% endfolding %}

{% endfolding %}

{% endfolding %}

Gallery 相册图库

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

1. gallerygroup 相册图库

   <div class="gallery-group-main">
   {% galleryGroup name description link img-url %}
   {% galleryGroup name description link img-url %}
   {% galleryGroup name description link img-url %}
   </div>

2. gallery 相册
   本地远程

   {% gallery %}
   markdown 图片格式
   {% endgallery %}
   
   {% gallery true,220,10 %}
   markdown 图片格式
   {% endgallery %}
   
   {% gallery true,,10 %}
   markdown 图片格式
   {% endgallery %}

   {% gallery url,[link],[lazyload],[rowHeight],[limit] %}
   {% endgallery %}

• gallerygroup 相册图库

参数	释义
name	图库名字
description	图库描述
link	链接到对应相册的地址
img-url	图库封面

思维拓展一下，相册图库的实质其实就是个快捷方式，可以自定义添加描述、封面、链接。那么我们未必要把它当做一个相册，完全可以作为一个链接卡片，链接到视频、QQ、友链都是不错的选择。

• gallery 相册
  区别于旧版的 Gallery 相册,新的 Gallery 相册会自动根据图片长度进行排版，书写也更加方便，与 markdown 格式一样。可根据需要插入到相应的 md。无需再自己配置长宽。建议在粘贴时故意使用长短、大小、横竖不一的图片，会有更好的效果。（尺寸完全相同的图片只会平铺输出，效果很糟糕）

  本地远程

  参数	释义
  lazyload	【可选】点击按钮加载更多图片，填写 true/false。默认为 false
  rowHeight	【可选】图片显示的高度，如果需要一行显示更多的图片，可设置更小的数字。默认为 220
  limit	【可选】每次加载多少张照片。默认为 10

  参数	释义
  url	【必须】 识别词
  link	【必须】远程的 json 链接
  lazyload	【可选】点击按钮加载更多图片，填写 true/false。默认为 false
  rowHeight	【可选】图片显示的高度，如果需要一行显示更多的图片，可设置更小的数字。默认为 220
  limit	【可选】每次加载多少张照片。默认为 10

  远程链接 Json 的例子
  有三个参数，url是必须存在的，alt 和 title 可有可无

  [
      {
          "url": "https://cdn1.tianli0.top/gh/jerryc127/CDN/img/IMG_0556.jpg",
          "alt": "IMG_0556.jpg",
          "title": "这是title"
      },
      {
          "url": "https://cdn1.tianli0.top/gh/jerryc127/CDN/img/IMG_0472.jpg",
          "alt": "IMG_0472.jpg"
      },
      {
          "url": "https://cdn1.tianli0.top/gh/jerryc127/CDN/img/IMG_0453.jpg",
          "alt": ""
      },
      {
          "url": "https://cdn1.tianli0.top/gh/jerryc127/CDN/img/IMG_0931.jpg",
          "alt": ""
      }
  ]

  示例

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

• gallerygroup 相册图库

MC

在Rikkaの六花服务器里留下的足迹

Gundam

哦咧哇gundam哒！

I-am-Akilar

某种意义上也算自拍吧

• gallery 相册

[{"url":"https://bu.dusays.com/2023/06/01/647896b15759c.jpg","alt":""},{"url":"https://bu.dusays.com/2023/06/01/647896cabde59.jpg","alt":""},{"url":"https://bu.dusays.com/2023/06/01/647896eb0f3ea.jpg","alt":""},{"url":"https://bu.dusays.com/2023/06/01/647890012b1ec.webp","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":""}]

加载更多

对于很多同学提问的gallerygroup和gallery相册页的链接问题。这里说下我个人的使用习惯。
一般使用相册图库的话，可以在导航栏加一个 gallery 的 page(使用指令hexo new page gallery添加)，里面放相册图库作为封面。然后在[Blogroot]/source/gallery/下面建立相应的文件夹，例如若按照这里的示例，若欲使用/gallery/MC/路径访问 MC 相册，则需要新建[Blogroot]/source/gallery/MC/index.md，并在里面填入gallery相册内容。

注意 ⚠️：本站相册集为单独优化，可参考配置相册页面

1. gallerygroup 相册图库

<div class="gallery-group-main">
 {% galleryGroup MC 在Rikkaの六花服务器里留下的足迹 '/wordScenery/' https://bu.dusays.com/2023/06/01/64788f24d05bd.webp %}
 {% galleryGroup Gundam 哦咧哇gundam哒！ '/thousand/' https://bu.dusays.com/2023/06/01/64788f456fc3d.webp %}
 {% galleryGroup I-am-Akilar 某种意义上也算自拍吧 '/wallpaper/' https://bu.dusays.com/2023/06/01/64788f83e5fa1.webp %}
</div>

2. gallery 相册

{% gallery true,,2 %}
![](https://bu.dusays.com/2023/06/01/647896b15759c.jpg)
![](https://bu.dusays.com/2023/06/01/647896cabde59.jpg)
![](https://bu.dusays.com/2023/06/01/647896eb0f3ea.jpg)
![](https://bu.dusays.com/2023/06/01/647890012b1ec.webp)
![](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 %}

tag-hide

如果你想把一些文字、内容隐藏起来，并提供按钮让用户点击显示。可以使用这个标签外挂。
请注意，tag-hide内的标签外挂content内都不建议有h1 - h6 等标题。因为Toc会把隐藏内容标题也显示出来，而且当滚动屏幕时，如果隐藏内容没有显示出来，会导致Toc的滚动出现异常。

inlineBlockToggle

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

( content不能包含英文逗号，可用‚)

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

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

Demo

哪个英文字母最酷？ {% hideInline 因为西装裤(C装酷),查看答案,#FF7242,#fff %}

门里站着一个人? {% hideInline 闪 %}

哪个英文字母最酷？ 查看答案
因为西装裤(C装酷)

门里站着一个人? Click
闪

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

( display 不能包含英文逗号，可用‚)

{% hideBlock display,bg,color %}
content
{% endhideBlock %}

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

Demo

查看答案
{% hideBlock 查看答案 %}
傻子，怎么可能有答案
{% endhideBlock %}

查看答案

查看答案

傻子，怎么可能有答案

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

( display 不能包含英文逗号，可用‚)

{% hideToggle display,bg,color %}
content
{% endhideToggle %}

Demo

展开

内容

链接卡片 link

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

{% link 标题, 站点描述, 链接, 图片链接（可选） %}

引用站外地址

获取网站的Favicon图标并显示在你的网页上

owen0o0

{% link 获取网站的Favicon图标并显示在你的网页上,owen0o0,https://github.com/owen0o0/getFavicon %}

单选列表 radio

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

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

• 颜色: red、yellow、green、cyan、blue、gray
• 选中状态: checked

纯文本测试

支持简单的 markdown 语法

支持自定义颜色

绿色

黄色

青色

蓝色

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

上标标签 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 %}

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

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

fontawesome图标需开启主题配置文件中icons.fontawesome

方法一

{% note [class] [no-icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}

方法二

{% 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 / blue / pink / red / purple / orange / green ）
no-icon	【可选】可配置自定义 icon (支持 fontawesome 图标和主题内置的阿里图标，fontawesome图标需开启主题配置文件中icons.fontawesome，也可以配置 no-icon )
style	【可选】可以覆盖配置中的 style（simple/modern/flat/disabled）

音频 audio

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

{% audio 音频链接 %}

{% audio https://npm.elemecdn.com/anzhiyu-music@1.0.4/%E9%9D%92%E8%8A%B1%E7%93%B7/%E9%9D%92%E8%8A%B1%E7%93%B7.mp3 %}

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