首页
第一屏

第一屏 home_banner

开关

配置项名称：home_banner.enable

类型可选值默认值
布尔值true | falsetrue

背景图片样式

配置项名称：home_banner.style

本配置项用于设置第一屏的背景图片样式，分为 static 和 fixed 两种。

类型可选值默认值
字符串static | fixedstatic

static 样式

static 样式为静态样式，即第一屏的背景图片会随着首页滚动而滚动。

fixed 样式

fixed 样式为固定样式，即第一屏的背景图片会作为背景固定在首页，不会随着首页滚动而滚动。同时本样式会让背景图片向下滑动时自动模糊，推荐使用。

背景图片

亮色模式

配置项名称：home_banner.image.light

类型备注示例
字符串本地相对链接/图片外链/images/wallhaven-wqery6-light.webp

暗色模式

配置项名称：home_banner.image.dark

类型备注示例
字符串本地相对链接/图片外链/images/wallhaven-wqery6-dark.webp

主标题

配置项名称：home_banner.title

类型备注示例
字符串无Theme Redefine

副标题

文字内容

配置项名称：home_banner.subtitle.text

有打字机动画效果，可以配置多个字符串，每个字符串会在打字机动画中循环显示。

如果需要开启一言，请先在本项随便写入一些内容。

类型备注示例
数组请用英文逗号分隔["This is the first message", "This is the second message", "etc"]

一言

副标题自动获取一言，详见一言 (opens in a new tab)。

如果需要本项开启，请先在 home_banner.subtitle.text 中随便写入一些内容，防止因为网络问题导致的无法显示问题。 比如可以在 home_banner.subtitle.text 中写入 ['Loading...']

  • home_banner.subtitle.hitokoto.enable：开关
  • home_banner.subtitle.hitokoto.api：一言 API 地址

API 地址可以指定句子类型，详见一言 API (opens in a new tab)。

高级：打字动画设置

  • typing_speed：打字速度（每毫秒打印的字母数）
  • backing_speed：退格速度（每毫秒退格的字母数）
  • starting_delay：开始延迟（毫秒）
  • backing_delay：退格延迟（毫秒）
  • loop：是否循环
  • smart_backspace：是否智能退格

文字颜色

设定标题和副标题的文字颜色。

亮色模式

配置项名称：home_banner.text_color.light

类型备注示例
字符串请填写 Hex 色值#fff

暗色模式

配置项名称：home_banner.text_color.dark

类型备注示例
字符串请填写 Hex 色值#d1d1b6

文字样式

标题字体大小

配置项名称：home_banner.text_style.title_size

类型备注示例
字符串请填写 CSS 支持的字体大小2.8rem

副标题字体大小

配置项名称：home_banner.text_style.subtitle_size

类型备注示例
字符串请填写 CSS 支持的字体大小1.5rem

标题与副标题行高

配置项名称：home_banner.text_style.line_height

类型备注示例
字符串请填写 CSS 支持的行高1.2

自定义字体

开关

配置项名称：home_banner.custom_font.enable

类型可选值默认值
布尔值true | falsefalse

字体名称

配置项名称：home_banner.custom_font.family

类型备注示例
字符串会作用在主标题和副标题上Noto Sans SC

字体 CSS 文件链接

配置项名称：home_banner.custom_font.url

类型备注示例
字符串字体样式文件地址（CSS）https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@400;500;700&display=swap

社交链接

开关

配置项名称：home_banner.social_links.enable

类型可选值默认值
布尔值true | falsefalse

链接

配置项名称：home_banner.social_links.links

请添加你的社交链接，格式如下，

如果是 fa-brands 图标，可以直接填写 Brands 图标名称，比如 github。

但是如果用的不是 fa-brands 图标，比如 fa-solid，则需要填写全名，比如 fa-solid fa-wand-magic-sparkles。

_config.redefine.yml
links:
    [fontawesome 图标名称(不是 HTML 代码)]: [你的社交链接地址]

可以前往 Font Awesome (opens in a new tab) 查看图标名称。

示例配置：

_config.redefine.yml
links:
    github: https://github.com
    twitter: https://twitter.com
    facebook: https://facebook.com
    instagram: https://instagram.com
    fa-solid fa-wand-magic-sparkles: https://example.com
    fa-regular fa-music: https://example.com

二维码

配置项名称：home_banner.social_links.qrs

可选，可添加你的二维码，格式如下，

如果是 fa-brands 图标，可以直接填写 Brands 图标名称，比如 weixin。

但是如果用的不是 fa-brands 图标，比如 fa-solid，则需要填写全名，比如 fa-solid fa-wand-magic-sparkles。

_config.redefine.yml
qrs:
    [fontawesome 图标名称(不是 HTML 代码)]: [二维码图片地址]

示例配置：

_config.redefine.yml
qrs:
    weixin: https://example.com/weixin.png
首页导航栏