主题配置

主题配置由当前主题定义,不同主题的配置项可能不同。默认主题包含站点信息、外观与主题、页面配置和关于页面四个分组。

以下为默认主题的配置说明。

站点信息

站长邮箱

站长的联系邮箱,显示在博客各页面供用户联系,如政策协议页面、友链页面等

站长简介

站长的个人简介,显示在博客侧边栏作者卡片中

主页地址

博客首页的完整地址,在页脚版权信息和文章版权声明中,用于作者主页跳转

建站日期

网站成立的日期,用于计算建站时长

外观与主题

背景图片

博客的背景图,支持粘贴图片 URL 或上传,能够使用 302 重定向随机图

侧边社交

显示在博客侧边栏的个人社交链接,JSON 数组格式(图标使用 Remix Icon 图标库)

页脚社交

显示在页面底部的社交链接,JSON 数组格式(图标使用 Remix Icon 图标库)

日间开始时间

按时间段自动切换明暗主题的明亮主题开始时间

夜间开始时间

按时间段自动切换明暗主题的暗色主题开始时间,当与日间开始时间相同时,始终使用明亮主题

字体配置

自定义博客字体,格式:字体文件URL|字体名称(推荐使用千字网)

页面配置

打字机文本

首页轮播显示的文本列表,JSON 数组格式,循环显示文本

首页布局

博客端首页文章卡片区域的布局,支持双列瀑布流和单列卡片

动态数量

控制博客端动态页面的动态展示条数,默认为 30,不建议数量太多,容易导致页面卡顿

公告

用于展示公告内容,支持 HTML 标签和内联样式

支持的标签:<br><p><strong><b><em><i><u><s><del><ins><mark><small><span><sub><sup><a href="..." target="...">

支持的样式:color

留言信

博客端留言页面展开留言信封后展示的文本,建议 8-10 行

友链描述

在友链申请页面,用于生成站点信息配置中的 description 字段

站点截图

在友链申请页面,用于生成站点信息配置中的 screenshot 字段

赞赏方式

添加不同的赞赏方式,显示在文章底部,由赞赏名称和赞赏二维码组成

公众号二维码

上传微信公众号的二维码图片,用于在订阅页面展示,方便用户扫码关注公众号获取文章推送

公众号名称

微信公众号的名称,显示在二维码下方

页脚链接

显示在页面底部右侧的链接,JSON 数组格式

站长形象

站长的形象照片,在关于页面个人介绍右侧展示

关于页面

个人描述

关于页面顶部的主要描述文本

描述提示

在个人描述下方的补充性文本

展览图片

个人资料下方的装饰性图片

个人资料

用于博主信息的公开介绍,支持六个关键词,JSON 数组格式

性格类型

用于展示 16Personalities,预设全部类型可快速选择

座右铭

展示两行文本组成的座右铭,JSON 数组格式

一言

在座右铭下方的补充性文本

联系方式

关于页面的联系方式列表,JSON 数组格式

创作平台

博主的其它创作平台列表,JSON 数组格式

版本信息

此网站技术栈版本信息,JSON 数组格式

站长联盟

加入的联盟/组织列表,JSON 数组格式

心路历程

关于本站的介绍和成长故事

菜单管理

每个主题在 theme.json 中定义菜单结构,管理端通过「主题配置」页面进行可视化编辑。

菜单类型

系统支持三种菜单类型,对应不同的前台显示位置:

类型显示位置说明
聚合菜单首页右上角点击展开的网格布局菜单
导航菜单页面顶部主导航栏菜单,支持下拉子菜单
页脚菜单页面底部页脚链接区域

菜单字段

每个菜单项支持以下字段:

字段类型必填说明
标题输入框菜单显示的名称
链接输入框菜单跳转的 URL
图标输入框Remix Icon 类名或图片 URL
排序数字数值越小排序越靠前
启用开关是否在前台显示

链接类型

类型说明示例
内部链接指向博客内部的页面//friend/about
外部链接指向外部网站的 URLhttps://github.com
空链接不跳转,用于分组标题javascript:void(0)

图标说明

菜单支持两种图标:

图标类型判断方式示例
Remix Icon非 URL 格式ri-home-line
图片图标http://https:/// 开头https://example.com/icon.png