主题设置
本文字数:837 字 | 阅读时长 ≈ 2 min

主题设置

本文字数:837 字 | 阅读时长 ≈ 2 min

文章缩略图

本主题支持对文章进行缩略图配置:

# 默认缩略图
defaultThumb:

# 随机缩略图设置
# 设为 0 则不使用主题自带的缩略图
# 不为 0 时表示默认随机缩略图的数量
randomThumb: 18

# 文章题图设置
# 启用则在文章页顶部显示缩略图
showPostThumb: true

文章缩略图出现的地方有首页,文章页顶部。

文章设置缩略图方法有三种,自定义字段thumb,文章第一张图片,默认缩略图。

优先级顺序为:自定义字段thumb → 文章第一张图片 → 默认缩略图 → 随机缩略图 → 无。

缩略图尺寸大小,高度至少250px,宽度大于高度,推荐高度为400px。

自定义字段thumb

在文章顶部添加thumb字段,可以填外链地址,要符合标准的url,以http(s)开头,也可以填写本地文件路径,比如/images/xxx.jpg,图片文件放置在主题的/source/images目录或其子目录下,图片后缀仅支持png,jpg,jpeg,webp。

若未添加thumb字段,或者添加的thumb字段不符合上述规则,则字段不生效,会使用下一优先级的缩略图配置。

文章第一张图片

主题会从文章正文中找出第一张图片的src 作为缩略图。若文章中没有插入图片,则会使用下一优先级缩略图配置。

默认缩略图

默认缩略图需要在配置文件中填写defaultThumb 字段,填写地址要求同自定义字段thumb,若留空或者地址不合法,则会使用下一优先级的缩略图配置。

随机缩略图

随机缩略图需要在配置文件中配置randomThumb字段。

randomThumb: 18

字段值为随机缩略图的数量,主题默认提供18张缩略图进行随机选择,如果需要新增图片或者删除图片,可以在source/images/thumbs目录下进行操作,注意,图片命名要为纯数字,从1开始,且后缀必须为jpg,比如1.jpg,自定义缩略图后,将randomThumb的值修改成文件夹内图片的数量。

无缩略图

若将randomThumb字段设为0,则表示禁用随机缩略图,则在首页缩略图部分显示个性化色块的颜色,在文章页顶部题图显示为灰色,所以建议至少开始随机缩略图选项。

文章题图

文章页顶部支持题图设置,若缩略图设置不为空,且showPostThumb设为true,则在文章页顶部会展示题图,图片内容为缩略图的内容。

个性化标徽

个性化标徽出现的地方有首页、分类页,标签页,作者页和相关文章

设置方法是在文章编辑内填写自定义字段,支持的字段如下

book 、 game 、 note 、 chat 、 code 、 image 、 web 、 link 、 design 、 lock

---
title: 文章标题
icon: book
...
---

个性化色块

个性化色块需要到外观设置那开启才能激活使用,色块出现的地方有首页,分类页,标签页,独立搜索页等等

设置方法是在文章编辑内填写自定义字段,支持的字段如下

blue、purple、green、yellow、red

---
title: 文章标题
color: blue
...
---