CC的部落格 外挂标签笔记
CC的部落格 外挂标签笔记 ,其中大部分完整转载至糖果屋店长原文,根据本站实际情况进行了增减
行内文本样式 text
{% u 文本内容 %} |
- 带 下划线 的文本
- 带
着重号 的文本 - 带
波浪线 的文本 - 带
删除线的文本 - 键盘样式的文本 command + D
- 密码样式的文本:
这里没有验证码
1. 带 {% u 下划线 %} 的文本 |
行内文本 span
{% span 样式参数(参数以空格划分), 文本内容 %} |
- 字体: logo, code
- 颜色: red,yellow,green,cyan,blue,gray
- 大小: small, h4, h3, h2, h1, large, huge, ultra
- 对齐方向: left, center, right
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:红色、黄色、绿色、青色、蓝色、灰色。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
康纳百川
康纳百川
- 彩色文字 |
段落文本 p
{% p 样式参数(参数以空格划分), 文本内容 %} |
- 字体: logo, code
- 颜色: red,yellow,green,cyan,blue,gray
- 大小: small, h4, h3, h2, h1, large, huge, ultra
- 对齐方向: left, center, right
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:红色
、黄色
、绿色
、青色
、蓝色
、灰色
。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。CC's Blog
CC's Blog
- 彩色文字 |
引用 note
最新版butterfly
标签支持引用fontawesome V5
图标,效果上已经优于volantis
的note标签。故不再额外引入volantis的note样式
。做样式适配好麻烦的啊,能偷懒就偷懒吧
以下是butterfly
主题的note写法。
修改主题配置文件
note: |
Note
标签外挂有两种用法。icons
和light_bg_offset
只对方法一生效。
方法一
{% note [class] [no-icon] [style] %} |
方法二
{% note [color] [icon] [style] %} |
方法一
参数 | 用法 |
---|---|
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) |
方法一
simple
样式默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
modern
样式默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
flat
样式默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
disabled
样式默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
no-icon
样式
方法二
simple样式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
modern样式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
flat样式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
disabled样式
你是刷 Visa 还是 UnionPay
2021年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
no-icon样式
方法一
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 %}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 %}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 %}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 %}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 %}
方法二
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 %}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 %}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 %}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 %}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
主要样式参考自小康的butterfly渐变背景标签,自己写了个tip.js
来渲染标签,精简了一下代码。
{% tip [参数,可选] %}文本内容{% endtip %} |
- 样式: success,error,warning,bolt,ban,home,sync,cogs,key,bell
- 自定义图标: 支持fontawesome。
默认情况
success
error
warning
bolt
ban
home
sync
cogs
key
bell
自定义font awesome图标
{% tip %}默认情况{% endtip %} |
动态标签 anima
动态标签的实质是引用了font-awesome-animation的css样式,不一定局限于tip标签,也可以是其他标签。
只不过这里tip.js
是糖果屋自己写的,所以店长清楚它会怎么被渲染成html,才用的这个写法。
可以熟读文档,使用html语言来编写其他标签类型。
{% tip [参数,可选] %}文本内容{% endtip %} |
更多详情请参看font-awesome-animation文档
- 将所需的CSS类添加到图标(或DOM中的任何元素)。
- 对于父级悬停样式,需要给目标元素添加指定CSS类,同时还要给目标元素的父级元素添加CSS类
faa-parent animated-hover
。(详情见示例及示例源码)
You can regulate the speed of the animation by adding the CSS class or . faa-fastfaa-slow - 可以通过给目标元素添加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 |
On DOM load(当页面加载时显示动画)
warning
ban
调整动画速度。
warning
ban
On hover(当鼠标悬停时显示动画)
warning
ban
On parent hover(当鼠标悬停在父级元素时显示动画)
warning
ban
On DOM load(当页面加载时显示动画)
{% tip warning faa-horizontal animated %}warning{% endtip %}
{% tip ban faa-flash animated %}ban{% endtip %}调整动画速度
{% tip warning faa-horizontal animated faa-fast %}warning{% endtip %}
{% tip ban faa-flash animated faa-slow %}ban{% endtip %}On hover(当鼠标悬停时显示动画)
{% tip warning faa-horizontal animated-hover %}warning{% endtip %}
{% tip ban faa-flash animated-hover %}ban{% endtip %}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) %} |
- 样式: plus, minus, times
- 颜色: red,yellow,green,cyan,blue,gray
- 选中状态: checked
{% checkbox 纯文本测试 %} |
单选列表 radio
{% radio 样式参数(可选), 文本(支持简单md) %} |
- 颜色: red,yellow,green,cyan,blue,gray
- 选中状态: checked
{% radio 纯文本测试 %} |
时间轴 timeline
{% timeline 时间线标题(可选) %} |
镜像站点增加 CloudFlare 的支持
- 评论系统增加
Twikoo
,为双评论模式,但都配有人工审核(继续打脸) - 友链去除了
Jquery
@卓越科技 - 增加编辑按钮,并根据文章和页面进行自适应平台标题显示
- 评论系统换为
Waline
(测试卡打脸) - 一些小改动
谷歌字体换为官方源
重新启用谷歌分析(慢还是要在乎海外表现啊)
评论系统换为需要登陆的
DIsqusJS
和LiveRe
,并在文章底部引导至语雀
评论区博客原文全部托管在
语雀
,开始用心经营语雀
,并且不要脸的申请了原创声明自动部署触发感谢
Gitlab
和百度云函数
立个Flag:不再折腾评论系统
因本人太菜,加上现在人其实不怎么会评论了,关于垃圾评论,登录至少劝退一波(确认无误)
引入了谷歌字体,由
DogeDoge
提供CDN
加速增加了站点地图单页面
去除了无用
js
引入封面换为静态图
SEO
优化,站点访问速度优化搜索换为
Algolia
其他更新,继续优化中……
关闭了Tidio
在线聊天(因此邮件订阅
文章更新方式-1,无所谓,也不会有人订阅)关闭了浏览器订阅文章更新通知(我也没什么公告
,临时公告采用snackbar
读取js的方式)关闭了百度统计
,不蒜子统计
关闭了阅读
模式,简繁
转换按钮限制了境外IP
访问某些页面主评论
系统换为 Twikoo全站默哀
日当天加入7秒弹窗
提示(单纯喜欢7,可手动关闭)其他小更改,后续可能会关闭封面
和顶部图
简而言之,因为本来就没人访问,体验不重要了
👆看上面
新增了邮件订阅,恢复了浏览器订阅
因使用Github Actions
配合gulp
、imagemin
定时自动压缩优化图片,导致文件名重写,批量修改文章图片链接以修复图片加载失败,现已正常显示
Github Actions
触发方式修改,并借助Actions
配置定时百度推送以优化SEO
,补齐封面
因不蒜子
证书到期原因,https协议无法访问,统计功能受限,恢复时间未知
停用
Valine
评论系统,换用Disqusjs
评论系统,保留Beaudar
评论系统加入在线聊天系统(由
Tidio
提供支持)
完成Github Actions
以及Gitlab CI
自动动部署,并配有自动更新Gitee
部署
因仓库以及博客采用匹配次级目录索引方式,Coding
、Netlify
、Vercel
无法正常索引和获取样式,已取消托管服务
{% timeline %} |
链接卡片 link
{% link 标题, 链接, 图片链接(可选) %} |
{% link 外挂标签, , https://cdn.jsdelivr.net/gh/ccknbc-backup/cdn/logo/logo.png %} |
按钮 btns
Volantis
的按钮使用的是btn
和btns
标签。btns
和butterfly
的button
不冲突,但是btn
会被强制渲染,导致部分参数失效,而且btn
的效果还是butterfly
的button
更好看些。所以就只适配了btns
。
{% btns 样式参数 %} |
- 圆角样式:rounded, circle
- 增加文字样式:可以在容器内增加
<b>标题</b>
和<p>描述文字</p>
- 布局方式:
默认为自动宽度,适合视野内只有一两个的情况。
参数 | 含义 |
---|---|
wide | 宽一点的按钮 |
fill | 填充布局,自动铺满至少一行,多了会换行 |
center | 居中,按钮之间是固定间距 |
around | 居中分散 |
grid2 | 等宽最多2列,屏幕变窄会适当减少列数 |
grid3 | 等宽最多3列,屏幕变窄会适当减少列数 |
grid4 | 等宽最多4列,屏幕变窄会适当减少列数 |
grid5 | 等宽最多5列,屏幕变窄会适当减少列数 |
如果需要显示类似「团队成员」之类的一组含有头像的链接:
或者含有图标的按钮:
圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中
如果需要显示类似「团队成员」之类的一组含有头像的链接:
{% btns circle grid5 %}
{% cell ccknbc, https://blog.ccknbc.cc, https://cdn.jsdelivr.net/gh/ccknbc-backup/cdn/logo/logo.png %}
{% cell ccknbc, https://blog.ccknbc.cc, https://cdn.jsdelivr.net/gh/ccknbc-backup/cdn/logo/logo.png %}
{% cell ccknbc, https://blog.ccknbc.cc, https://cdn.jsdelivr.net/gh/ccknbc-backup/cdn/logo/logo.png %}
{% cell ccknbc, https://blog.ccknbc.cc, https://cdn.jsdelivr.net/gh/ccknbc-backup/cdn/logo/logo.png %}
{% cell ccknbc, https://blog.ccknbc.cc, https://cdn.jsdelivr.net/gh/ccknbc-backup/cdn/logo/logo.png %}
{% endbtns %}或者含有图标的按钮:
{% btns rounded grid5 %}
{% cell 下载源码, /, fas fa-download %}
{% cell 查看文档, /, fas fa-book-open %}
{% endbtns %}圆形图标 + 标题 + 描述 + 图片 + 网格5列 + 居中
{% 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 %}
github卡片 ghcard
ghcard使用了github-readme-stats
的API,支持直接使用markdown语法来写。
{% ghcard 用户名, 其它参数(可选) %} |
更多参数可以参考:
使用,
分割各个参数。写法为:参数名=参数值
以下只写几个常用参数值。
参数名 | 取值 | 释义 |
---|---|---|
hide | stars,commits,prs,issues,contribs | 隐藏指定统计 |
count_private | true | 将私人项目贡献添加到总提交计数中 |
show_icons | true | 显示图标 |
theme | 请查阅Available Themes | 主题 |
用户信息卡片
| {% ghcard ccknbc %} | {% ghcard ccknbc, theme=vue %} |
| -- | -- |
| {% ghcard ccknbc, theme=buefy %} | {% ghcard ccknbc, theme=solarized-light %} |
| {% ghcard ccknbc, theme=onedark %} | {% ghcard ccknbc, theme=solarized-dark %} |
| {% ghcard ccknbc, theme=algolia %} | {% ghcard ccknbc, theme=calm %} |仓库信息卡片
| {% ghcard ccknbc-actions/blogroll %} | {% ghcard ccknbc-actions/blogroll, theme=vue %} |
| -- | -- |
| {% ghcard ccknbc-actions/blogroll, theme=buefy %} | {% ghcard ccknbc-actions/blogroll, theme=solarized-light %} |
| {% ghcard ccknbc-actions/blogroll, theme=onedark %} | {% ghcard ccknbc-actions/blogroll, theme=solarized-dark %} |
| {% ghcard ccknbc-actions/blogroll, theme=algolia %} | {% ghcard ccknbc-actions/blogroll, theme=calm %} |
github徽标 ghbdage
关于ghbdage参数的更多具体用法可以参看糖果屋教程:添加github徽标
{% bdage [right],[left],[logo]||[color],[link],[title]||[option] %} |
left
:徽标左边的信息,必选参数。right
: 徽标右边的信息,必选参数,logo
:徽标图标,图标名称详见simpleicons,可选参数。color
:徽标右边的颜色,可选参数。link
:指向的链接,可选参数。title
:徽标的额外信息,可选参数。主要用于优化SEO,但object
标签不会像a
标签一样在鼠标悬停显示title
信息。option
:自定义参数,支持shields.io的全部API参数支持,具体参数可以参看上文中的拓展写法示例。形式为name1=value2&name2=value2
。
本外挂标签的参数分为三组,用||
分割。
2. 信息参数
3. 拓展参数
本外挂标签的参数分为三组,用||
分割。
基本参数,定义徽标左右文字和图标
{% bdage Theme,Butterfly %}
{% bdage Frame,Hexo,hexo %}信息参数,定义徽标右侧内容背景色,指向链接
{% bdage CDN,JsDelivr,jsDelivr||abcdef,https://metroui.org.ua/index.html,本站使用JsDelivr为静态资源提供CDN加速 %}
//如果是跨顺序省略可选参数,仍然需要写个逗号,用作分割
{% bdage Source,GitHub,GitHub||,https://github.com/ %}拓展参数,支持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 %} |
{% sitegroup %} |
行内图片 inlineimage
{% inlineimage 图片链接, height=高度(可选) %} |
- 高度:height=20px
这是 一段话。
这又是 一段话。
这是 {% inlineimage https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/aru-l/0000.gif %} 一段话。 |
单张图片 image
{% image 链接, width=宽度(可选), height=高度(可选), alt=描述(可选), bg=占位颜色(可选) %} |
- 图片宽度高度:width=300px, height=32px
- 图片描述:alt=图片描述(butterfly需要在主题配置文件中开启图片描述)
- 占位背景色:bg=#f2f2f2
添加描述:
每天下课回宿舍的路,没有什么故事。指定宽度:
指定宽度并添加描述:
每天下课回宿舍的路,没有什么故事。设置占位背景色:
优化不同宽度浏览的观感
添加描述:
{% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, alt=每天下课回宿舍的路,没有什么故事。 %}
指定宽度:
{% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, width=400px %}
指定宽度并添加描述:
{% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, width=400px, alt=每天下课回宿舍的路,没有什么故事。 %}
设置占位背景色:
{% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, width=400px, bg=#1D0C04, alt=优化不同宽度浏览的观感 %}
音频 audio
{% audio 音频链接 %} |
{% audio https://file.nmb.show/down.php/fc178ad5791961bf520fcfc7e4f0b450.flac %} |
视频 video
{% video 视频链接 %} |
- 对其方向:left, center, right
- 列数:逗号后面直接写列数,支持 1 ~ 4 列。
100%宽度
50%宽度
25%宽度
100%宽度
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
50%宽度
{% videos, 2 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% endvideos %}25%宽度
{% videos, 4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% video https://file.nmb.show/down.php/86c301fbc6183f50fb0487e13e5a1f64.mp4 %}
{% endvideos %}
相册 gallery
Butterfly
自带gallery
相册,而且会根据图片大小自动调整排版,效果比Volantis
的gallery
更好,故不再收录Volantis
的gallery
标签。
以下为Butterfly
自带的gallery
标签写法。相册图库和相册配合使用。
- gallerygroup 相册图库
<div class="gallery-group-main"> |
- gallery 相册
{% gallery %} |
gallerygroup 相册图库
参数名 释义 name 图库名字 description 图库描述 link 链接到对应相册的地址 img-url 图库封面 思维拓展一下,相册图库的实质其实就是个快捷方式,可以自定义添加描述、封面、链接。那么我们未必要把它当做一个相册,完全可以作为一个链接卡片,链接到视频、QQ、友链都是不错的选择。
gallery 相册
区别于旧版的Gallery相册,新的Gallery相册会自动根据图片长度进行排版,书写也更加方便,与markdown格式一样。可根据需要插入到相应的md。无需再自己配置长宽。建议在粘贴时故意使用长短、大小、横竖不一的图片,会有更好的效果。(尺寸完全相同的图片只会平铺输出,效果很糟糕)
对于很多同学提问的gallerygroup
和gallery
相册页的链接问题。这里说下 Aki 个人的使用习惯。
一般使用相册图库的话,可以在导航栏加一个gallery的page(使用指令hexo new page gallery
添加),里面放相册图库作为封面。然后在[Blogroot]/source/gallery/
下面建立相应的文件夹,例如若按照这里的示例,若欲使用/gallery/MC/
路径访问MC相册,则需要新建[Blogroot]/source/gallery/MC/index.md
,并在里面填入gallery
相册内容。
gallerygroup 相册图库
<div class="gallery-group-main">
{% galleryGroup 'demo' '仅仅是一个测试' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2020-10-05~20_05_18.webp %}
{% galleryGroup '真世代' '让真情反映世代,让情感串联台湾' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2020-10-05~20_08_18.webp %}
{% galleryGroup '工具' '工具' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2021-03-18~09-25-11.webp %}
{% galleryGroup '学习' '学习' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2021-03-18~09-33-28.webp %}
{% galleryGroup '博客' '博客' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2021-03-18~09-12-14.webp %}
{% galleryGroup '音乐' '音乐' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2021-03-18~09-42-19.webp %}
{% galleryGroup '工作' '工作' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2021-03-18~09-39-40.webp %}
{% galleryGroup '台湾' '台湾' '#相册-gallery' https://cdn.jsdelivr.net/gh/ccknbc-backup/photos/blog/2021-03-18~09-51-39.webp %}
</div>gallery 相册
{% gallery %}





{% endgallery %}
折叠框 folding
Butterfly
虽然也有内置折叠框hideToggle
标签,但是Volantis
的folding
折叠框更好看一些。
{% folding 参数(可选), 标题 %} |
- 颜色:blue, cyan, green, yellow, red
- 状态:状态填写 open 代表默认打开。
查看图片测试
查看默认打开的折叠框
这是一个默认打开的折叠框。
查看代码测试
 |
查看列表测试
- haha
- hehe
查看嵌套测试
查看嵌套测试2
查看嵌套测试3
hahaha
{% folding 查看图片测试 %} |
分栏 tab
Butterfly
的tab
标签和Volantis
的tab
标签都是移值自NexT
主题,所以写法和效果一模一样。
{% tabs Unique name, [index] %} |
- Unique name :
- 选项卡块标签的唯一名称,不带逗号。
- 将在#id中用作每个标签及其索引号的前缀。
- 如果名称中包含空格,则对于生成#id,所有空格将由破折号代替。
- 仅当前帖子/页面的URL必须是唯一的!
- [index]:
- 活动选项卡的索引号。
- 如果未指定,将选择第一个标签(1)。
- 如果index为-1,则不会选择任何选项卡。
- 可选参数。
- [Tab caption]:
- 当前选项卡的标题。
- 如果未指定标题,则带有制表符索引后缀的唯一名称将用作制表符的标题。
- 如果未指定标题,但指定了图标,则标题将为空。
- 可选参数。
- [@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 - 预设选择第一个【默认】
{% tabs test1 %} |
Demo 2 - 预设选择tabs
{% tabs test2, 3 %} |
Demo 3 - 没有预设值
{% tabs test3, -1 %} |
Demo 4 - 自定义Tab名 + 只有icon + icon和Tab名
{% tabs test4 %} |
数据集合 issues
{% issues type | api=url | group=key:value1,value2(可选) %} |
type(类型):
根据需求不同,会将 issues 内容解析成不同的 HTML 标签,目前支持的类型有:
时间轴
timeline
: 解析成timeline
标签,issue
的标题对应timeline
的时间,issue
的内容对应timeline
的内容。网站卡片
sites
: 解析成sites
标签,需要有JSON
代码块,各参数对应sites
标签参数:{
"title": "",
"screenshot": "",
"url": "",
"avatar": "",
"description": "",
"「keywords」": ""
}
参数 | 释义 |
---|---|
title | 网站名称 |
screenshot | 网站预览图 |
url | 网站链接,需要添加https:// 协议组成完整域名。否则可能被识别成站点相对路径。 |
avatar | 站长头像 |
「keywords」 | 分组依据, 未必要叫「keywords」, 详见下文group(分组) |
api(接口):
url为可以调的通的API,例如:
api=https://gitee.com/api/v5/repos/xaoxuu/friends/issues?sort=updated&state=open&page=1&per_page=100&labels=active |
参数 | 释义 |
---|---|
https://gitee.com/api/v5/ | gitee仓库的api |
https://api.github.com/ | github仓库的api |
repos/xaoxuu/friends/issues | repos/用户名/仓库名/issues |
sort=updated&state=open | 界定哪些类型的issues 会被读取过来渲染成相应的标签 |
page=1&per_page=100 | 读取前100条issues |
labels=active | 控制默认的issue不显示, 只有自己审核通过 添加了active标签之后才会显示 |
group(分组):sites
类型的issues
默认不分组,如果需要分组,可指定分组依据「keywords」
,和分组白名单「value1」
、「value2」
等,例如:
group=version:v4,v3,v2 |
这个参数的作用就是,筛选出JSON
中包含"version": "v4"
或者"version":"v3"
或者"version": "v2"
的数据,并分组显示。
仓库ISSUES模板配置
Github仓库配置方案
新建一个仓库,仓库名随意,这里 Aki 命名为
friend_link
,
新建文件friend_link\.github\ISSUE_TEMPLATE.md
,
并在其中输入以下内容作为issues
模板。其中的json代码块前面的反斜杠记得删去。此处这么写主要是为了转义,否则无法嵌套代码块。
---
name: 友链模板
about: 请根据指示规范填写友链格式。
---
<!-- 请在下方代码块的双引号中填写 -->
\```json
{
"title": "",
"screenshot": "",
"url": "",
"avatar": "",
"description": "",
"keywords": ""
}
\```
<!--
"title": "站点名称",
"screenshot": "站点预览图链接",
"url": "站点链接",
"avatar": "头像链接",
"description": "站点描述",
"keywords": "关键词,作为分组名"
-->
<!-- 示例 -->
<!--
"title": "Akilarの糖果屋",
"screenshot": "https://cdn.jsdelivr.net/gh/Akilarlxh/ScreenShot@gh-pages/akilar.top.jpg",
"url": "https://akilar.top/",
"avatar": "https://akilar.top/img/siteicon/favicon.png",
"description": "期待您的光临!",
"keywords": "糖果屋"
-->新建active label
提交示例
从审核通过到页面读取有一段api的缓存期,稍微有点耐心。
Gitee仓库配置方案
新建一个仓库,仓库名随意,这里 Aki 命名为
friend_link
,
新建文件friend_link\.gitee\ISSUE_TEMPLATE.md
,
并在其中输入以下内容作为issues
模板。其中的json代码块前面的反斜杠记得删去。此处这么写主要是为了转义,否则无法嵌套代码块。
---
name: 友链模板
about: 请根据指示规范填写友链格式。
---
<!-- 请在下方代码块的双引号中填写 -->
\```json
{
"title": "",
"screenshot": "",
"url": "",
"avatar": "",
"description": "",
"keywords": ""
}
\```
<!--
"title": "站点名称",
"screenshot": "站点预览图链接",
"url": "站点链接",
"avatar": "头像链接",
"description": "站点描述",
"keywords": "关键词,作为分组名"
-->
<!-- 示例 -->
<!--
"title": "Akilarの糖果屋",
"screenshot": "https://cdn.jsdelivr.net/gh/Akilarlxh/ScreenShot@gh-pages/akilar.top.jpg",
"url": "https://akilar.top/",
"avatar": "https://akilar.top/img/siteicon/favicon.png",
"description": "期待您的光临!",
"keywords": "糖果屋"
-->新建active标签
提交示例
从审核通过到页面读取有一段api的缓存期,稍微有点耐心。
因本主题已去 jquery 化(我也不想要,这个标签也不怎么用,不过那个时间线可以用来发说说什么的),所以为了正常显示需要先引入相关依赖,这里不再演示,请直接查看源码即可
<script defer src="https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js"></script> |
时间轴标签
timeline
渲染{% issues timeline | api=https://gitee.com/api/v5/repos/xaoxuu/timeline/issues?state=open&creator=xaoxuu&sort=created&direction=desc&page=1&per_page=100 %}
网站卡片标签
sites
渲染- gitee仓库示例
{% issues sites | api=https://gitee.com/api/v5/repos/xaoxuu/friends/issues?sort=updated&state=open&page=1&per_page=100&labels=active %}
- github仓库示例
{% issues sites | api=https://api.github.com/repos/xaoxuu/friends/issues?sort=updated&state=open&page=1&per_page=100&labels=active %}
- gitee仓库示例
网站卡片标签
sites
分组渲染
这是Volantis
主题官网的「示例博客」页面的数据:{% issues sites | api=https://api.github.com/repos/volantis-x/examples/issues?sort=updated&state=open&page=1&per_page=100 | group=version:版本:^4.0,版本:^3.0,版本:^2.0 %}
诗词标签 poem
{% poem [title],[author] %} |
- title:诗词标题
- author:作者,可以不写
明月几时有?把酒问青天。
不知天上宫阙,今夕是何年?
我欲乘风归去,又恐琼楼玉宇,高处不胜寒。
起舞弄清影,何似在人间?
转朱阁,低绮户,照无眠。
不应有恨,何事长向别时圆?
人有悲欢离合,月有阴晴圆缺,此事古难全。
但愿人长久,千里共婵娟。
{% poem 水调歌头,苏轼 %} |
进度条 progress
进度条标签参考沂佰孜猫-给HEXO文章添加彩色进度条。
源样式提取自Cuteen主题。
{% progress [width] [color] [text] %} |
width
: 0到100的阿拉伯数字color
: 颜色,取值有red,yellow,green,cyan,blue,graytext
:进度条上的文字内容
{% progress 10 red 进度条样式预览 %} |
媒体 mmedia
简介
hexo-tag-mmedia 是一个能在 Hexo 中快速插入媒体标签的插件,目前支持的标签和平台有(持续开发中):
DEMO
http://demo.hexo-tag-mmedia.u2sb.com/
使用
hexo-tag-mmedia 插件和其他 hexo 插件使用方法类似,诸如 如何启用一个插件 之类的共性问题就不再赘述了,只说 hexo-tag-mmedia 相关的。
安装
npm install hexo-tag-mmedia@1 --save |
pnpm install hexo-tag-mmedia@1 --save |
yarn add hexo-tag-mmedia@1 --save |
配置
如需修改配置,请务必不要保留空选项,空选项会覆盖默认配置,严重可能直接导致插件无法使用。
单项使用的文档中会详细讲解对应的使用文档,请自行阅读后再做配置。
下面只是示例,请勿全盘复制,请看清后面的讲解后组织自己的配置文件。
持续更新中,详情见详细文档和 源码
mmedia: |
解释
- 配置项较多目的是给予最大的自定义权限,默认情况下不做配置也可以使用。
- 配置文件放在博客根目录的
_config.yml
中 - default 为默认配置,在
_config.yml
中填写就不需要在每个标签全部写入了,所有允许在 mmedia 标签上写入的配置项,均可在 default 下配置。 - default 下 contents 项,用于设置 JSON 类型的默认配置,注意要使用 yaml 格式写默认配置,以下是几个示例。
示例
如无法读懂下面的示例,请阅读后面的文档后再回来看。
修改 Aplayer 的 js 文件:
mmedia: |
将 Aplayer 的 JS 和 CSS 放入博客目录:
首先请下载 APlayer.min.js
和 APlayer.min.js
文件,放入博客下 source/assets/js/
和 source/assets/css/
下(路径只是示例)
mmedia: |
Meting 修改循环方式为随机循环:
mmedia: |
Dplayer 修改弹幕 API:
mmedia: |
使用
下面只是快速示例,请阅读后面的文档后再回来看。示例只是为了展示配置方式瞎写的,一些配置不一定正确,不要照抄。
{% mmedia "audio" "src:a.mp3" %} |
{% mmedia "aplayer" "name:songName" "url:a.mp3" %} |
{% mmedia "meting" "auto=https://y.qq.com/n/yqq/song/001RGrEX3ija5X.html" %} |
{% mmedia "bilibili" "bvid:BV1hb4y1R7xf" %} |
{% mmedia "xigua" "xid=6925997698269053453" %} |
{% mmedias "dplayer" "flv:" "url:https://dandoc.u2sb.com/video/%E5%AE%89%E8%A3%85/1-%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%89%E8%A3%85.mp4" %} |
{% mmedias "aplayer" "autoplay:false" %} |
使用原则
必看
规则
标签
markdown 内可以使用两种标签作为插件,分别是 mmedia
和 mmedias
,使用方式为:
{% mmedia %} |
{% mmedias %} |
只使用 args
作为传参方式时,两种标签均可使用,当需要使用 contents
传参时,只能使用 mmedias
。
后面第一个参数用于标记标签,可选(以详细文档为主,持续更新中):
audio
video
meting
aplayer
dplayer
bilibili
xigua
再后面的参数将直接作为 args
参数直接传入插件。
参数
传入标签的参数可以写入到三个位置,分别为:_config.yml
,args
,contents
,其中只有部分插件可使用 contents
配置,具体看详细文档,如有冲突项,覆盖规则为(后面的会被前面发覆盖):
contents
-> args
-> _config.yml
-> 插件默认
写入到 args
上的参数,有两种写法,分别是使用 :
和 =
分割,两种写法是等效的,在遇到第一个 :
或 =
时会自动分割,例如:
{% mmedia "bilibili" "bvid:BV1hb4y1R7xf" %} |
两种写法是等效的。
如果遇到布尔类型的参数,可以简写
{% mmedia "audio" "src:a.mp3" "autoplay:" %} |
{% mmedia "audio" "src:a.mp3" "autoplay:true" %} |
两种写法等效,但需要注意,:
或 =
一定不能省略。
JSON 传参
支持 JSON 方式传参,其中 JSON 为 JSON5 规范。
示例:
{% mmedias "aplayer" "autoplay:false" %} |
从 0.x 升级
考虑到一部分用户 0.x 版本使用时间较长,迁移成本较高,遂将 0.x 单独发布为一个包,可以用 1.x 版本同时安装。
详情见 0.X 版本。
虽然能兼容使用,但建议及时修改文章到 1.x ,0.x 版本已不再继续维护。
开发者要说的几句话
- 这个插件并不完美,如果使用中遇到问题,请熟读文档,如果还是有问题,请再读一遍文档,还是有问题,请向开发者反馈。
- 关于 JS 重复请求,请升级客户端浏览器版本,两个一样的 JS,只会请求一次,暂时没有想到什么好的办法,如果有,请及时告诉 Aki 。
- 关于 pjax,这东西真的不想去做兼容(其实也不难),如果以后闲得无聊的话,可能会做,但不要催 Aki 关于 pjax 兼容的问题。
- 不要局限于示例,放开手脚,大胆去尝试,这个插件的开放性真的非常的大。
介绍
可以插入 html5 原生 audio 标签
使用
{% mmedia "audio" "src:a.mp3" %} |
{% mmedia "audio" "src:https://baidu.com/a.mp3" "autoplay:true" %} |
参数
此部分请熟读 Audio 相关介绍
- 使用
:
或=
分割。 - 所有
<audio>
标签的原生参数均可添加,只要能写进去就可以。 - 具体能否实现相关标准,取决于客户端浏览器。
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,使用 JSON5 标准。
配置
默认配置可写入 _config.yml
下
mmedia: |
介绍
可以插入 html5 原生 video 标签
使用
{% mmedia "video" "src:a.mp4" %} |
{% mmedia "video" "src:https://baidu.com/a.mp4" "autoplay:true" %} |
参数
此部分请熟读 Video 相关介绍
- 使用
:
或=
分割。 - 所有
<video>
标签的原生参数均可添加,只要能写进去就可以。 - 具体能否实现相关标准,取决于客户端浏览器。
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,使用 JSON5 标准。
配置
默认配置可写入 _config.yml
下
mmedia: |
介绍
可以插入 MetingJS 标签。
使用
{% mmedia "meting" "auto=https://y.qq.com/n/yqq/song/001RGrEX3ija5X.html" %} |
{% mmedia "meting" "server=netease" "type=playlist" "id=60198" %} |
参数
此部分请熟读 MetingJS 文档
- 使用
:
或=
分割。 - 所有
<meting-js>
标签的参数均可添加,只要能写进去就可以。
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,使用 JSON5 标准。
{% mmedias "meting" "server=netease" %} |
配置
默认配置可写入 _config.yml
下
mmedia: |
介绍
可以插入 aplayer 标签
使用
{% mmedia "aplayer" "name:songName" "url:a.mp3" %} |
{% mmedias "aplayer" "autoplay:false" %} |
参数
此部分请熟读 APlayer 文档
- 使用
:
或=
分割。
详细参数表:
参数 | 默认 | 解释 |
---|---|---|
name | - | audio name |
artist | - | audio artist |
url | - | audio url |
cover | - | audio cover |
lrc | - | audio lrc |
theme | - | audio theme |
type | auto | audio type 可选 ‘auto’, ‘hls’, ‘normal’ |
autoplay | false | autoplay |
loop | ‘all’ | player loop play, values: ‘all’, ‘one’, ‘none’ |
order | ‘list’ | player play order, values: ‘list’, ‘random’ |
volume | 0.7 | default volume, |
tlistMaxHeight | - | list max height |
不在表格内的参数请使用下面 JSON 类型的参数。
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,由于允许使用 JSON5,此项配置几乎与 APlayer 完全一致。
详情请见上方示例。
配置
默认配置可写入 _config.yml
下
mmedia: |
介绍
可以插入 dplayer 标签。
使用
{% mmedia "dplayer" "url:a.mp4" %} |
{% mmedias "dplayer" "flv:" "url:https://dandoc.u2sb.com/video/%E5%AE%89%E8%A3%85/1-%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%89%E8%A3%85.mp4" %} |
参数
此部分请熟读 DPlayer 文档
- 使用
:
或=
分割。
详细参数表:
参数 | 默认 | 解释 |
---|---|---|
url | - | video.url |
pic | - | video.pic |
thumbnails | - | video.thumbnails |
type | auto | video.type, values: ‘auto’, ‘hls’, ‘flv’, ‘dash’, ‘webtorrent’, ‘normal’ or other |
autoplay | false | video autoplay |
loop | false | video loop |
logo | - | showing logo in the top left corner, you can adjust its size and position by CSS |
volume | 0.7 | default volume |
screenshot | false | enable screenshot, if true, video and video poster must enable Cross-Origin |
id | - | danmaku.id, danmaku pool id, it must be unique |
api | - | danmaku.api, see Danmaku API |
上面有一个比较特殊的参数 flv,这里单独解释一下,这个参数是用于引入其他 js 文件的,目前支持的有:hls
dash
shaka_dash
flv
webtorrent
,上述参数可多个一起使用,如果后面带有 js 地址,将直接使用,否则将使用 _config.yml
配置或插件默认配置,如:
{% mmedia "dplayer" "flv:" "url:a.flv" %} |
{% mmedias "dplayer" "flv:" "hls:https://cdn.jsdelivr.net/npm/hls.js/dist/hls.min.js" %} |
不在表格内的参数请使用下面 JSON 类型的参数。
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,由于允许使用 JSON5,此项配置几乎与 DPlayer 完全一致。
详情请见上方示例。
配置
默认配置可写入 _config.yml
下
mmedia: |
介绍
可以插入 artplayer 标签。
使用
{% mmedia "artplayer" "url:https://dandoc.u2sb.com/video/%E5%AE%89%E8%A3%85/1-%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%89%E8%A3%85.mp4" %} |
{% mmedias "artplayer" "flv:" %} |
参数
此部分请熟读 ArtPlayer 文档
- 使用
:
或=
分割。
详细参数表:
参数 | 默认 | 解释 |
---|---|---|
url | - | url |
title | - | title |
poster | - | poster |
type | - | type |
autoplay | false | video autoplay |
loop | false | video loop |
volume | 0.7 | default volume |
style | - | style |
上面有一个比较特殊的参数 flv,这里单独解释一下,这个参数是用于引入其他 js 文件的,目前支持的有:hls
dash
shaka_dash
flv
webtorrent
,上述参数可多个一起使用,如果后面带有 js 地址,将直接使用,否则将使用 _config.yml
配置或插件默认配置,如:
{% mmedia "artplayer" "flv:" "url:a.flv" %} |
{% mmedias "artplayer" "flv:" "hls:https://cdn.jsdelivr.net/npm/hls.js/dist/hls.min.js" %} |
不在表格内的参数请使用下面 JSON 类型的参数。
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,由于允许使用 JSON5,此项配置几乎与 ArtPlayer 完全一致。
详情请见上方示例。
配置
默认配置可写入 _config.yml
下
mmedia: |
介绍
可以插入 bilibili 视频
使用
{% mmedia "bilibili" "bvid:BV1br4y1P7ND" %} |
{% mmedia "bilibili" "bvid:BV1br4y1P7ND" "danmaku:false" %} |
参数
- 使用
:
或=
分割。
详细参数表:
参数 | 默认 | 解释 |
---|---|---|
aid | - | aid |
bvid | - | bvid,与 aid 同时出现时以 bvid 为准 |
page | 1 | page |
danmaku | true | 是否有弹幕 ture or false |
allowfullscreen | allowfullscreen | 允许全屏, allowfullscreen 或 true 允许,其他选项不允许 |
sandbox | 见 配置 | iframe sandbox |
width | 100% | css 属性 |
max_width | 850px | css 属性 |
margin | auto | css 属性 |
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,使用 JSON5 标准。
配置
默认配置可写入 _config.yml
下
mmedia: |
介绍
可以插入 西瓜 视频
使用
{% mmedia "xigua" "xid=6925997698269053453" %} |
{% mmedia "xigua" "xid:6925997698269053453" "autoplay:true" %} |
参数
- 使用
:
或=
分割。
详细参数表:
参数 | 默认 | 解释 |
---|---|---|
xid | - | 西瓜视频的 ID,就是那一串数字 |
id | - | 一般情况下不需要填写 |
autoplay | false | autoplay |
startTime | 0 | 开始时间,秒 |
allowfullscreen | allowfullscreen | 允许全屏, allowfullscreen 或 true 允许,其他选项不允许 |
sandbox | 见 配置 | iframe sandbox |
width | 100% | css 属性 |
max_width | 850px | css 属性 |
margin | auto | css 属性 |
JSON 参数
mmedia 插件允许在 contents 部分使用 JSON 编写配置,使用 JSON5 标准。
配置
默认配置可写入 _config.yml
下
mmedia: |
待开发……
请前往 音乐界面 预览部分效果,分别用到了 Artplayer, Aplayer, Dplayer, Meting,一下仅作为写法备份
{% mmedias "artplayer" %} |
动态图表 chartjs
示例源码
{% chart 90% 300 %} |
关于预览,更多详细内容,请分别前往 插件文档 | 原文档 查看(因 pjax 原因,我排除了 ‘chart*’ 因此控制台会出现闪现报错情况)
未完待续