自定义短语示例

总结摘要
将常用的块引用、标签卡、按钮等信息设置成短代码,便于快速引用

虽然 Markdown 语法已经非常丰富能够满足我们写文章的绝大部分需求,但是为更好的对文章内容进行更友好的排版,为引设计一套自定义的短语,便于在使用时能够快速引用。

块引用

在引用一些经典名言名句时,可以采用此短语,语法参考如下:

1
2
3
4
{{< quote >}}
  ### block quote
  写下你想表达的话语!
{{< /quote >}}

实际效果:

希望是无所谓有,无所谓无的,这正如地上的路。

其实地上本没有路,走的人多了,也便成了路。

鲁迅

信息块

支持 defaultinfosuccesswarningdanger 等五种不同效果的展示,语法参考如下:

1
2
3
4
{{< note [class] [no-icon] >}}
  书写表达的信息
  支持 Markdown 语法
{{< /note >}}

实际效果:

Default Header without icon

Welcome to Hugo NexT!

Default Header

Welcome to Hugo NexT!

Primary Header

Welcome to Hugo NexT!

Info Header

Welcome to Hugo NexT!

Success Header

Welcome to Hugo NexT!

Warning Header

Welcome to Hugo NexT!

Danger Header

Welcome to Hugo NexT!

Bilibili 视频

1
2
3
{{< bilibili BV1Sx411T7QQ >}}
或者
{{< bilibili id=BV1Sx411T7QQ >}}

音乐播放器

基于 APlayer MetingJS 库实现见面内嵌的响应式音乐播放器,自动识别的音乐平台URL,包括:neteasetencentkugoubaiduxiami 平台,也可以支持用户自定义的音乐源。其他相关的参数说明如下:

参数名默认说明
id必选音乐 ID,即音乐在音乐平台的唯一标识符
server必选音乐平台,支持 neteasetencentkugoubaiduxiami 平台
type必选播放类型,目前支持 songplaylistalbumsearchartist 类型
auto可选音乐的地址,仅支持 server 参数中的平台
theme#448aff播放器的主题色,默认为 #448aff
url自定的音乐源 URL,默认为空
name音乐名称,默认为空
artist音乐作者,默认为空
cover音乐封面 URL,默认为空
fixedfalse固定播放器,默认为 false
minifalse显示小播放器,默认为 false
autoplayfalse自动播放,默认为 false
loopall循环播放,支持allonenone,默认为 all
orderlist播放顺序listrandom,支持默认为 list
volume0.7音量,默认为 0.7
mutextrue有多个音乐播放时,是否只开启当前播放器,默认为 true
list-foldedfalse列表折叠,默认为 false
list-max-height340px列表最大高度,默认为:340px

单曲播放

1
{{< music theme="#2980b9" server="tencent" type="song" id="002u4ZTb0CXmJA" mini="true" >}}

列表播放

1
{{< music server="netease" type="playlist" id="1982066521" list-max-height="140" >}}

自定义音乐源

1
{{< music music url="/music/sky.mp3" name="天空之城" artist="宫崎骏" cover="/music/gongqijun.jpg" autoplay="true" >}}