侧边栏

字段:widgets 侧边栏小部件显示什么、显示多少个、顺序如何完全由博主给定的顺序决定。

通用字段

如无特殊说明,所有的小部件都至少支持下面这些通用字段:

字段含义是否必须值类型默认值
widget表示这个小部件是什么类型详见【widget枚举值】plain
enable是否启用Booltrue
icon左上角的图标String‘’
title标题String‘’
more右上角的按钮详见【more】-

字段:widget 代表小部件的类型,取值有以下几种:

取值含义
author博主信息小部件
category文章分类小部件
tagcloud标签云小部件
toc文章目录小部件
music音乐小部件
plain纯文本小部件
list列表小部件

字段:more 小部件右上角的按钮

字段含义是否必须
icon按钮图标
url按钮的链接
animate按钮hover时的动画
targeta标签的target属性
rela标签的rel属性

字段:animate 取值有以下几种:

取值含义
rotate90顺时针旋转90度

博主信息小部件

博主信息小部件不支持上述的通用字段中的icontitlemore,以下只显示博主信息小部件特有字段:

字段含义是否必须值类型默认值
avatar头像String‘’
title标题String‘’
body正文String‘’
social社交信息Boolfalse

纯文本小部件

字段含义是否必须值类型默认值
widget表示这个小部件是什么类型必须是’plain’plain
body正文内容,支持markdown语法。markdown‘’

列表小部件

字段含义是否必须值类型默认值
widget表示这个小部件是什么类型必须是’list’plain
rows每一行元素详见【rows】-

rows:

字段含义是否必须值类型默认值
name名称String‘’
img方形图片否,不设置时是空白String‘’
avatar圆形图片否,不设置时是空白String‘’
icon图标否,不设置时是空白String‘’
url链接String‘’
desc描述文字String‘’
targeta标签的target属性String‘’
rela标签的rel属性String‘’

注意:一行的img、avatar和icon字段如果提供了多个,最多只会显示一个。

文章分类小部件

字段含义是否必须值类型默认值
widget表示这个小部件是什么类型必须是’category’plain

标签云小部件

字段含义是否必须值类型默认值
widget表示这个小部件是什么类型必须是’tagcloud’plain

音乐小部件

字段含义是否必须值类型默认值
widget表示这个小部件是什么类型必须是’music’plain

字段以及取值详见【第三方服务 -> APlayer】

TOC目录小部件

没有特有字段,并且不支持通用字段中的more,因为其右上角的按钮具有特殊作用。

示例

在主题的配置文件中:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# 侧边栏小部件,默认按下面给定的顺序全部显示,文章中还可以自定义显示一部分以及顺序
sidebar:
- widget: author
avatar: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/avatar/avatar.png
social: true
- widget: toc
- widget: grid
icon: fas fa-map-signs
title: 站内导航
rows:
- name: 近期文章
icon: fas fa-clock
url: /
- name: 文章归档
icon: fas fa-archive
url: blog/archives/
rel: nofollow
- name: 开源项目
icon: fas fa-code-branch
url: projects/
- name: 歌单分享
icon: fas fa-compact-disc
url: music/
rel: nofollow
- name: 我的友链
icon: fas fa-link
url: friends/
rel: nofollow
- name: 主题文档
icon: fas fa-book
url: https://xaoxuu.com/wiki/material-x/
rel: nofollow
- name: 关于小站
icon: fas fa-info-circle
url: about/
rel: nofollow
- widget: category
more:
icon: fas fa-expand-arrows-alt
url: blog/categories/
rel: nofollow
- widget: tagcloud
icon: fas fa-fire
more:
icon: fas fa-expand-arrows-alt
url: blog/tags/
rel: nofollow
- widget: related_posts # 需要安装插件 npm i -S hexo-related-popular-posts
- widget: music
icon: fas fa-compact-disc
title: "最近在听"
more:
icon: far fa-heart
url: https://music.163.com/#/user/home?id=63035382
rel: external nofollow noopener noreferrer
target: _blank
server: netease # netease(网易云音乐)tencent(QQ音乐) xiami(虾米) kugou(酷狗)
type: playlist # song (单曲) album (专辑) playlist (歌单) search (搜索)
id: 2615636388 # 歌曲/专辑/歌单 ID



评论