4.7 KiB
| title | description | keywords | date | lastmod | categories | tags | url | toc | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 自定义短语示例 | 将常用的块引用、标签卡、按钮等信息设置成短代码，便于快速引用 | shortcode,短代码 | 2022-08-06T14:41:50+08:00 | 2022-08-06T14:41:50+08:00 |
|
|
demo/shortcodes.html | true |
虽然 Markdown 语法已经非常丰富能够满足我们写文章的绝大部分需求，但是为更好的对文章内容进行更友好的排版，为引设计一套自定义的短语，便于在使用时能够快速引用。
块引用
在引用一些经典名言名句时，可以采用此短语，语法参考如下：
{{</* quote */>}}
### block quote
写下你想表达的话语！
{{</* /quote */>}}
实际效果：
{{< quote >}}
希望是无所谓有，无所谓无的，这正如地上的路。
其实地上本没有路，走的人多了，也便成了路。
鲁迅
{{< /quote >}}
信息块
支持 default，info，success，warning，danger 等五种不同效果的展示，语法参考如下：
{{</* note [class] [no-icon] */>}}
书写表达的信息
支持 Markdown 语法
{{</* /note */>}}
实际效果：
{{< note default no-icon >}}
Default Header without icon
Welcome to Hugo NexT! {{< /note >}}
{{< note default >}}
Default Header
Welcome to Hugo NexT! {{< /note >}}
{{< note primary >}}
Primary Header
Welcome to Hugo NexT! {{< /note >}}
{{< note info >}}
Info Header
Welcome to Hugo NexT! {{< /note >}}
{{< note success >}}
Success Header
Welcome to Hugo NexT! {{< /note >}}
{{< note warning >}}
Warning Header
Welcome to Hugo NexT! {{< /note >}}
{{< note danger >}}
Danger Header
Welcome to Hugo NexT! {{< /note >}}
Bilibili 视频
{{</* bilibili BV1Sx411T7QQ */>}}
或者
{{</* bilibili id=BV1Sx411T7QQ */>}}
{{< bilibili id=BV1Sx411T7QQ >}}
音乐播放器
基于APlayer和MetingJS库实现见面内嵌的响应式音乐播放器，自动识别的音乐平台URL，包括：netease、 tencent、 kugou、 baidu 和 xiami 平台，也可以支持用户自定义的音乐源。其他相关的参数说明如下：
| 参数名 | 默认 | 说明 |
|---|---|---|
| id | 必选 | 音乐 ID，即音乐在音乐平台的唯一标识符 |
| server | 必选 | 音乐平台，支持 netease、 tencent、 kugou、 baidu 和 xiami 平台 |
| type | 必选 | 播放类型，目前支持 song 、 playlist、 album、 search 和 artist 类型 |
| auto | 可选 | 音乐的地址，仅支持 server 参数中的平台 |
| theme | #448aff |
播放器的主题色，默认为 #448aff |
| url | 空 | 自定的音乐源 URL，默认为空 |
| name | 空 | 音乐名称，默认为空 |
| artist | 空 | 音乐作者，默认为空 |
| cover | 空 | 音乐封面 URL，默认为空 |
| fixed | false |
固定播放器，默认为 false |
| mini | false |
显示小播放器，默认为 false |
| autoplay | false |
自动播放，默认为 false |
| loop | all |
循环播放，支持all、one 和 none，默认为 all |
| order | list |
播放顺序list 和 random，支持默认为 list |
| volume | 0.7 |
音量，默认为 0.7 |
| mutex | true |
有多个音乐播放时，是否只开启当前播放器，默认为 true |
| list-folded | false |
列表折叠，默认为 false |
| list-max-height | 340px |
列表最大高度，默认为：340px |
单曲播放
{{</* music theme="#2980b9" server="tencent" type="song" id="002u4ZTb0CXmJA" mini="true" */>}}
{{< music theme="#2980b9" server="tencent" type="song" id="002u4ZTb0CXmJA" mini="true" >}}
列表播放
{{</* music server="netease" type="playlist" id="1982066521" list-max-height="140" */>}}
{{< music server="netease" type="playlist" id="1982066521" list-max-height="140" >}}
自定义音乐源
{{</* music music url="/music/sky.mp3" name="天空之城" artist="宫崎骏" cover="/music/gongqijun.jpg" autoplay="true" */>}}
{{< music url="/music/sky.mp3" name="天空之城" artist="宫崎骏" cover="/music/gongqijun.jpg" autoplay="true" >}}