Butterfly外挂标签用法学习
注意:此页面偶尔会存在CSS冲突问题!
Markdown语法自带格式
代码块
快捷键:Ctrl + Shift + K
或者使用英文输入三个(`)符号 就是1旁边的(~)键
1 | ``` |
多级标题
1 | # H1 |
表格
缺点:内容不容易居中
颜色名称 | 英语 | 效果 |
---|---|---|
黑色 | black | |
蓝色 | blue | |
红色 | red |
1 | <table> |
1 | 在Markdown中,通过在表头和表格内容之间添加:,可以控制内容的对齐方式: |
项目标号 | 资金 | 备注 |
---|---|---|
1 | 100,000 | 无 |
2 | 200,000 | 无 |
3 | 300,600 | 重要 |
1 | | 项目标号 | 资金 | 备注 | |
分隔线
1 | *** |
文字url跳转
点击查看效果
1 | [点击跳转到百度](https://www.baidu.com/) |
引用
内容一
内容二
1 | 内容一 |
插入图片
1 | 引入图片链接: |
文字样式
下划线演示
文字加粗演示
文字斜体演示
文本高亮
演示
文本删除线演示
5号字
黑体
蓝色
这里的背景色是:MistyRosen,此处输入任意想输入的内容 |
1 | <u>下划线演示</u> |
这里的背景色是:LavenderBlush,此处输入任意想输入的内容 |
这里的背景色是:LightCoral,此处输入任意想输入的内容 |
这里的背景色是:LightCyan,此处输入任意想输入的内容 |
这里的背景色是:rgba(135, 206, 250, 0.5),此处输入任意想输入的内容 |
这里的背景色是:hsl(60, 100%, 80%),此处输入任意想输入的内容 |
这里的背景色是:PeachPuff,此处输入任意想输入的内容 |
这里的背景色是:#FFD700,此处输入任意想输入的内容 |
这里的背景色是:PaleGreen,此处输入任意想输入的内容 |
这里的背景色是:rgba(255, 160, 122, 0.5),此处输入任意想输入的内容 |
这里的背景色是:hsl(180, 100%, 90%),此处输入任意想输入的内容 |
列表、序列(*,+,-跟空格都可以)
- Java
- Python
- …
- Java
- Python
- …
- Java
- Python
- …
1 | * Java |
- 上山打老虎
1 | # 注意标点后面要空格 |
折叠
样例
内容内容内容1 | <details> |
外挂标签用法学习
分栏tab
建议先学习分栏tab后面很常用
看图片后就知道怎么用了
1 | ### 大标题一 |
1 | <!-- tab 标题二 --> |
1 | <!-- tab 标题三 --> |
1 | <!-- tab 标题四 --> |
1 | ### 大标题一 |
预览图片写法
1 | {% hideBlock 点我预览, lightred %} |
1 | {% hideBlock 点我预览, 自行修改的颜色 %} |
其它颜色名称可看下面表格
颜色名称 | 英语 | 效果 |
---|---|---|
黑色 | black | |
蓝色 | blue | |
红色 | red | |
绿色 | green | |
黄色 | yellow | |
灰色 | gray | |
白色 | white | |
紫色 | purple | |
橙色 | orange | |
深蓝色 | darkblue | |
浅蓝色 | lightblue | |
深绿色 | darkgreen | |
浅绿色 | lightgreen | |
深红色 | darkred | |
浅红色 | lightred | |
粉红色 | pink | |
青色 | cyan | |
棕色 | brown |
行内文本样式
- 带 下划线 的文本
- 带
着重号 的文本 - 带
波浪线 的文本 - 带
删除线的文本 - 键盘样式的文本 command + D
- 密码样式的文本:
这里没有验证码
1 | 1. 带 {% u 下划线 %} 的文本 |
行内文本 span
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:红色、黄色、绿色、青色、蓝色、灰色。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
路飞
我要成为海贼王的男人!
1 | - 彩色文字 |
1 | 语法:{% span 样式参数(参数以空格划分), 文本内容 %} |
字体
: logo, code颜色
: red,yellow,green,cyan,blue,gray大小
: small, h4, h3, h2, h1, large, huge, ultra对齐方向
: left, center, right
段落文本 p
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:红色
、黄色
、绿色
、青色
、蓝色
、灰色
。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。路飞
我要成为海贼王的男人!
1 | - 彩色文字 |
1 | 标签语法:{(参数以空格划分), 文本内容 } p 样式参数 |
字体
: logo, code颜色
: red,yellow,green,cyan,blue,gray大小
: small, h4, h3, h2, h1, large, huge, ultra对齐方向
: left, center, right
折叠框 folding
查看图片测试
查看默认打开的折叠框
这是一个默认打开的折叠框。
查看代码测试
假装这里有代码块(代码块没法嵌套代码块)
查看列表测试
- haha
- hehe
查看嵌套测试
查看嵌套测试2
查看嵌套测试3
hahaha
1 | {% folding 查看图片测试 %} |
1 | {% folding 参数(可选), 标题 %} |
颜色
:blue, cyan, green, yellow, red状态
:状态填写 open 代表默认打开。
引用note(提示块标签)
总有一款你会心动 点击看图
修改配置文件
需要先到_config.butterfly.yml
文件中配置1
2
3
4
5
6
7
8
9
10
11
12note:
# 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
配置参数
语法格式1
2
3
4
5
6
7
8# 自带icon
{% note [class] [no-icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}
# 外部icon
{% note [color] [icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}
自带icon
参数 | 用法 |
---|---|
class | 【可选】标识,不同的标识有不同的配色 ( default / primary / success / info / warning / danger ) |
no-icon | 【可选】不显示 icon |
style | 【可选】可以覆盖配置中的 style (simple/modern/flat/disabled) |
外部icon
参数 | 用法 |
---|---|
class | 【可选】标识,不同的标识有不同的配色 ( default / blue / pink / red / purple / orange / green ) |
no-icon | 【可选】可配置自定义 icon (只支持 fontawesome 图标, 也可以配置 no-icon ) |
style | 【可选】可以覆盖配置中的 style (simple/modern/flat/disabled) |
自带icon(提示块标签)
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
1 | {% note simple %}默认 提示块标签{% endnote %} |
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
1 | {% note modern %}默认 提示块标签{% endnote %} |
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
1 | {% note flat %}默认 提示块标签{% endnote %} |
1 | {% note no-icon %}默认 提示块标签{% endnote %} |
外部icon(提示块标签)
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
1 | {% note 'fab fa-cc-visa' simple %}你是刷 Visa 还是 UnionPay{% endnote %} |
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
1 | {% note 'fab fa-cc-visa' modern %}你是刷 Visa 还是 UnionPay{% endnote %} |
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
1 | {% note 'fab fa-cc-visa' flat %}你是刷 Visa 还是 UnionPay{% endnote %} |
1 | {% note no-icon %}你是刷 Visa 还是 UnionPay{% endnote %} |
复选列表 checkbox
1 | {% checkbox 纯文本测试 %} |
1 | 标签语法:{% checkbox 样式参数(可选), 文本(支持简单md) %} |
样式
: plus, minus, times颜色
: red,yellow,green,cyan,blue,gray选中状态
: checked
单选列表 radio
1 | {% radio 纯文本测试 %} |
1 | {% radio 样式参数(可选), 文本(支持简单md) %} |
颜色
: red,yellow,green,cyan,blue,gray选中状态
: checked
时间轴 timeline
时间轴样式
2024-08-08 2.6.6 -> 3.0
- 博客安装
Butterfly外挂标签
- 更新文章
2024-08-07
- 博客添加
乔巴
和路飞
动态GIF - 更新文章
2024-08-06 2.6.2 -> 2.6.3
- 美化F12控制台
1 | {% timeline 时间轴样式,blue %} |
参数说明: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
链接卡片 link
1 | {% link 糖果屋教程贴, https://akilar.top/posts/615e2dec/, https://cdn.cbd.int/akilar-candyassets@1.0.36/image/siteicon/favicon.ico %} |
1 | {% link 标题, 链接, 图片链接(可选) %} |
按钮 btns
如果需要显示类似「团队成员」之类的一组含有头像的链接
或者含有图标的按钮
圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中
- 如果需要显示类似「团队成员」之类的一组含有头像的链接
1
2
3
4
5
6
7{% btns circle grid5 %}
{% cell xaoxuu, https://www.yooupi.site, https://www.yooupi.site/img/top-img/4.jpg %}
{% cell xaoxuu, https://www.yooupi.site, https://www.yooupi.site/img/top-img/4.jpg %}
{% cell xaoxuu, https://www.yooupi.site, https://www.yooupi.site/img/top-img/4.jpg %}
{% cell xaoxuu, https://www.yooupi.site, https://www.yooupi.site/img/top-img/4.jpg %}
{% cell xaoxuu, https://www.yooupi.site, https://www.yooupi.site/img/top-img/4.jpg %}
{% endbtns %} - 或者含有图标的按钮
1
2
3
4{% btns rounded grid5 %}
{% cell 下载源码, /, fas fa-download %}
{% cell 查看文档, /, fas fa-book-open %}
{% endbtns %} - 圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中
1
2
3
4
5
6
7
8
9
10
11
12
13
14{% btns circle center grid5 %}
<a href='https://apps.apple.com/cn/app/heart-mate-pro-hrm-utility/id1463348922?ls=1'>
<i class='fab fa-apple'></i>
<b>心率管家</b>
{% p red, 专业版 %}
<img src='https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/qrcode/heartmate_pro.png'>
</a>
<a href='https://apps.apple.com/cn/app/heart-mate-lite-hrm-utility/id1475747930?ls=1'>
<i class='fab fa-apple'></i>
<b>心率管家</b>
{% p green, 免费版 %}
<img src='https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/qrcode/heartmate_lite.png'>
</a>
{% endbtns %}
标签语法:1
2
3
4{% btns 样式参数 %}
{% cell 标题, 链接, 图片或者图标 %}
{% cell 标题, 链接, 图片或者图标 %}
{% endbtns %}
- 圆角样式:rounded, circle
- 增加文字样式:可以在容器内增加
<b>
标题</b>
和<p>
描述文字</p>
- 布局方式:
默认为自动宽度,适合视野内只有一两个的情况。
参数 | 含义 |
---|---|
wide | 宽一点的按钮 |
fill | 填充布局,自动铺满至少一行,多了会换行 |
center | 居中,按钮之间是固定间距 |
around | 居中分散 |
grid2 | 等宽最多2列,屏幕变窄会适当减少列数 |
grid3 | 等宽最多3列,屏幕变窄会适当减少列数 |
grid4 | 等宽最多4列,屏幕变窄会适当减少列数 |
grid5 | 等宽最多5列,屏幕变窄会适当减少列数 |
文本内容隐藏
点我预览
1 | {% hideInline 隐藏的内容,隐藏,bg,color %} |
github卡片 ghcard
- 用户信息卡片
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 %} | - 仓库信息卡片
1
2
3
4
5
6| {% 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 %} |
标签语法:1
2{% ghcard 用户名, 其它参数(可选) %}
{% ghcard 用户名/仓库, 其它参数(可选) %}
更多参数可以参考:
https://github.com/anuraghazra/github-readme-stats
使用,
分割各个参数。写法为:参数名=参数值
以下只写几个常用参数值。
参数名 | 取值 | 释义 |
---|---|---|
hide | stars,commits,prs,issues,contribs | 隐藏指定统计 |
count_private | true | 将私人项目贡献添加到总提交计数中 |
show_icons | true | 显示图标 |
theme | 请查阅Available Themes | 主题 |
网站卡片 sites
1 | {% sitegroup %} |
标签语法:1
2
3
4{% sitegroup %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接(可选), description=描述(可选) %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接(可选), description=描述(可选) %}
{% endsitegroup %}
行内图片 inlineimage
这是 一段话。
这又是 一段话。
1 | 这是 {% inlineimage https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/aru-l/0000.gif %} 一段话。 |
高度
:height=20px标签语法
:1
{% inlineimage 图片链接, height=高度(可选) %}
单张图片 image
添加
描述
:指定
宽度
指定
宽度
并添加描述
:设置
占位背
景色:
1 | 1. 添加`描述`: |
- 图片宽度高度:width=300px, height=32px
- 图片描述:alt=图片描述(butterfly需要在主题配置文件中开启图片描述)
- 占位背景色:bg=#f2f2f2
- 标签语法:
1
{% image 链接, width=宽度(可选), height=高度(可选), alt=描述(可选), bg=占位颜色(可选) %}
视频 video
100%宽度
50%宽度
25%宽度
1 | 1. 100%宽度 |
- 对齐方向:left, center, right
- 列数:逗号后面直接写列数,支持 1 ~ 4 列。
- 标签语法:
1
{% video 视频链接 %}
音频 audio
1 | {% audio https://github.com/volantis-x/volantis-docs/releases/download/assets/Lumia1020.mp3 %} |
1 | {% audio 音频链接 %} |
相册 gallery
- gallerygroup 相册图库
- gallery 相册
1 | 1. gallerygroup 相册图库 |
- gallerygroup 相册图库
参数名 | 释义 |
---|---|
name | 图库名字 |
description | 图库描述 |
link | 链接到对应相册的地址 |
img-url | 图库封面 |
思维拓展一下,相册图库的实质其实就是个快捷方式,可以自定义添加描述、封面、链接。那么我们未必要把它当做一个相册,完全可以作为一个链接卡片,链接到视频、QQ、友链都是不错的选择。
- gallery 相册
success 区别于旧版的Gallery相册,新的Gallery相册会自动根据图片长度进行排版,书写也更加方便,与markdown格式一样。可根据需要插入到相应的md。无需再自己配置长宽。建议在粘贴时故意使用长短、大小、横竖不一的图片,会有更好的效果。(尺寸完全相同的图片只会平铺输出,效果很糟糕)
- gallerygroup 相册图库
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> - gallery 相册
1
2
3{% gallery %}
markdown 圖片格式
{% endgallery %}
其实Butterfly
自带gallery
相册,而且会根据图片大小自动调整排版,效果比Volantis
的gallery
更好。
gallerygroup
和gallery
相册页的链接问题。一般使用相册图库的话,可以在导航栏加一个gallery
的page
(使用指令hexo new page gallery
添加),里面放相册图库作为封面。然后在[Blogroot]/source/gallery/
下面建立相应的文件夹,例如若按照这里的示例,若欲使用/gallery/MC/
路径访问MC相册,则需要新建[Blogroot]/source/gallery/MC/index.md
,并在里面填入gallery
相册内容。
诗词标签 poem
丙辰中秋,欢饮达旦,大醉,作此篇,兼怀子由。
明月几时有?把酒问青天。
不知天上宫阙,今夕是何年?
我欲乘风归去,又恐琼楼玉宇,高处不胜寒。
起舞弄清影,何似在人间?
转朱阁,低绮户,照无眠。
不应有恨,何事长向别时圆?
人有悲欢离合,月有阴晴圆缺,此事古难全。
但愿人长久,千里共婵娟。
1 | {% poem 水调歌头,苏轼 %} |
title
:诗词标题author
:作者,可以不写
阿里图标 icon
1 | {% icon icon-rat_zi %}{% icon icon-rat,2 %} |
icon-xxxx
:表示图标font-class,可以在自己的阿里矢量图标库项目的font-class引用方案内查询并复制。font-size
:表示图标大小,直接填写数字即可,单位为em。图标大小默认值为1em。标签语法
:1
{% icon [icon-xxxx],[font-size] %}
参考其他
:https://akilar.top/posts/d2ebecef/
进度条 progress
进度条标签参考沂佰孜猫-给HEXO文章添加彩色进度条。
源样式提取自Cuteen主题。
1 | {% progress [width] [color] [text] %} |
width
: 0到100的阿拉伯数字color
: 颜色,取值有red,yellow,green,cyan,blue,graytext
:进度条上的文字内容
1 | {% progress 10 red 进度条样式预览 %} |
注释 notation
1 | {% nota [label] , [text] %} |
label
: 注释词汇text
: 悬停显示的注解内容
1 | {% nota 把鼠标移动到我上面试试 ,可以看到注解内容出现在顶栏 %} |
把鼠标移动到我上面试试
气泡注释 bubble
1 | {% bubble [content] , [notation] ,[background-color] %} |
content
: 注释词汇notation
: 悬停显示的注解内容background-color
: 可选,气泡背景色。默认为“#71a4e3”
1 | 最近我学到了不少新玩意儿(虽然对很多大佬来说这些已经是旧技术了),比如CSS的{% bubble 兄弟相邻选择器,"例如 h1 + p {margin-top:50px;}" %},{% bubble flex布局,"Flex 是 Flexible Box 的缩写,意为"弹性布局",用来为盒状模型提供最大的灵活性","#ec5830" %},{% bubble transform变换,"transform 属性向元素应用 2D 或 3D 转换。该属性允许我们对元素进行旋转、缩放、移动或倾斜。","#1db675" %},animation的{% bubble 贝塞尔速度曲线,"贝塞尔曲线(Bézier curve),又称贝兹曲线或贝济埃曲线,是应用于二维图形应用程序的数学曲线。一般的矢量图形软件通过它来精确画出曲线,贝兹曲线由线段与节点组成,节点是可拖动的支点,线段像可伸缩的皮筋","#de4489" %}写法,还有今天刚看到的{% bubble clip-path,"clip-path属性使用裁剪方式创建元素的可显示区域。区域内的部分显示,区域外的隐藏。","#868fd7" %}属性。这些对我来说很新颖的概念狠狠的冲击着我以前积累起来的设计思路。 |
最近我学到了不少新玩意儿(虽然对很多大佬来说这些已经是旧技术了),比如CSS的兄弟相邻选择器例如 h1 + p {margin-top:50px;}</span>,flex布局Flex 是 Flexible Box 的缩写,意为弹性布局”,用来为盒状模型提供最大的灵活性”</span>,transform变换transform 属性向元素应用 2D 或 3D 转换。该属性允许我们对元素进行旋转、缩放、移动或倾斜。</span>,animation的贝塞尔速度曲线贝塞尔曲线(Bézier curve),又称贝兹曲线或贝济埃曲线,是应用于二维图形应用程序的数学曲线。一般的矢量图形软件通过它来精确画出曲线,贝兹曲线由线段与节点组成,节点是可拖动的支点,线段像可伸缩的皮筋</span>写法,还有今天刚看到的clip-pathclip-path属性使用裁剪方式创建元素的可显示区域。区域内的部分显示,区域外的隐藏。</span>属性。这些对我来说很新颖的概念狠狠的冲击着我以前积累起来的设计思路。
引用文献 reference
1 | {% referto [id] , [literature] %} |
referto 引用上标
id
: 上标序号内容,需与referfrom标签的id对应才能实现跳转literature
: 引用的参考文献名称
referfrom 引用出处
id
: 序号内容,需与referto标签的id对应才能实现 跳转literature
: 引用的参考文献名称url
: 引用的参考文献链接,可省略
1 | Akilarの糖果屋(akilar.top)是一个私人性质的博客{% referto '[1]','Akilarの糖果屋群聊简介' %},从各类教程至生活点滴,无话不谈。建群的目的是提供一个闲聊的场所。博客采用Hexo框架{% referto '[2]','Hexo中文文档' %},Butterfly主题{% referto '[3]','Butterfly 安装文档(一) 快速开始' %} |
Akilarの糖果屋(akilar.top)是一个私人性质的博客</span>[1]Akilarの糖果屋群聊简介参考资料</span></span>,从各类教程至生活点滴,无话不谈。建群的目的是提供一个闲聊的场所。博客采用Hexo框架</span>[2]Hexo中文文档参考资料</span></span>,Butterfly主题</span>[3]Butterfly 安装文档(一) 快速开始参考资料</span></span>
本项目参考了Volantis</span>[4]hexo-theme-volantis 标签插件参考资料</span></span>的标签样式。引入[tag].js
,并针对butterfly
主题修改了相应的[tag].styl
。在此鸣谢Volantis
主题众开发者。
主要参考内容包括各个volantis的内置标签插件文档</span>[5]Volantis文档:内置标签插件参考资料</span></span>
Butterfly主题的各个衍生魔改</span>[6]Butterfly 安装文档:标签外挂(Tag Plugins参考资料</span></span></span>[7]小弋の生活馆全样式预览参考资料</span></span></span>[8]l-lin-font-awesome-animation参考资料</span></span></span>[9]小康的butterfly主题使用文档参考资料</span></span>