主题配置项
你可以在后台"主题设置"界面中直接修改这些配置项。
提示
当你的站点已经安装了最新版本的主题后，可在下方填写你的站点链接。
即可在本文档启用快速跳转链接，一键跳转到后台对应配置项。
站点链接
示例
🎯 用途
说明配置项用途。
📂 配置项位置
说明在主题配置项的位置。
⚡ 快速跳转
点击即可快速跳转到对应主题配置项。
🏷️ 类型
此配置项的值类型。
以下举例几个常见类型
- 字符串：一串字符，如
abc123、zh-CN。 - 整数：整数，如
-1、0、100。 - 浮点数：带小数点的数，如
1.2、0.3、4.5。 - 布尔值：
true或false。体现为一个单选框🔘，打勾☑️就是true，不勾🔘就是false。 - 选项：提供了固定选项，直接选择即可。
- 重复器：可重复一组输入。可增加组，移除组，交换任意组顺序。
- 代码输入框（编程语言）：提供一个多行的代码输入框，会按照指定编程语言进行高亮。
- 附件：选择上传的附件。
💡 示例值
再举几个例子便于理解。
🔒 内部约束
如果填写的配置值不满足这个要求，将无法保存配置。
⚠️ 外部约束
如果填写的配置值不满足这个要求，主题可能无法正常工作。
🧩 模板变量
提供给模板开发者使用的变量，用于读取此配置值。可通过 ${模板变量} 使用。
ℹ️ 补充信息
补充说明一些信息。
全局
默认页面语言
🎯 用途
指定站点根标签 <html> 的 lang 属性默认值，用于辅助无障碍、SEO 以及浏览器/插件的语言感知（例：浏览器是否弹出页面翻译提醒）。
📂 配置项位置
全局 -> 默认页面语言
🏷️ 类型
字符串
⭐ 默认值
zh
💡 示例值
zh、zh-CN、zh-Hans、en、en-US
⚠️ 外部约束
设定值需满足 BCP 47，否则无效。
🧩 模板变量
theme.config?.global?.default_page_language
ℹ️ 补充信息
- 安全性：设定的语言值的会自动转义，无需担心 XSS 注入攻击。
- 设定优先级：请查阅页面语言设定优先级。
多语言功能前缀匹配模式
🎯 用途
启用多语言功能的前缀匹配模式，使主题能够更灵活地匹配语言设置。
📂 配置项位置
全局 -> 多语言功能前缀匹配模式
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.global?.is_i18n_prefix_match_mode
ℹ️ 补充信息
具体使用方法请参考前缀匹配模式说明。
浏览器按语言自动跳转
🎯 用途
根据浏览器的语言设置，自动跳转到对应语言的页面。
📂 配置项位置
全局 -> 浏览器按语言自动跳转
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.global?.is_auto_redirect_to_browser_language
允许跳转的目标区域语言代码列表
🎯 用途
设定允许的自动跳转目标语言。
🏷️ 类型
重复器
⭐ 默认值
空
🧩 模板变量
theme.config?.global?.auto_redirect_target_language_list
多语言菜单支持
🎯 用途
启用多语言菜单支持，允许在菜单中显示不同语言的内容。
📂 配置项位置
全局 -> 多语言菜单支持
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.global?.is_i18n_menu_show
ℹ️ 补充信息
启用后请参照多语言菜单使用指南进行配置。
CSP:upgrade-insecure-requests
🎯 用途
自动将非跳转的不安全资源请求升级到 HTTPS，包括当前域名以及第三方请求。
📂 配置项位置
全局 -> CSP:upgrade-insecure-requests
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.global?.upgrade_insecure_requests
仅允许使用指定域名访问
🎯 用途
防止站点被恶意镜像后的流量流失，仅允许白名单中的域名访问。
📂 配置项位置
全局 -> 仅允许使用指定域名访问
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.global?.anti_mirror_site
域名白名单列表
🎯 用途
设定域名白名单列表。
🏷️ 类型
重复器
⭐ 默认值
空
💡 示例值
📂 配置项名
Base64 编码后的域名
🏷️ 类型
字符串
💡 示例值
bG9jYWxob3N0
🔒 内部约束
必填项
🧩 模板变量
theme.config?.global?.allow_site_whitelist
ℹ️ 补充信息
请参照开启仅允许使用指定域名访问进行配置。
目标链接
🎯 用途
设定域名白名单列表。
🏷️ 类型
字符串
⭐ 默认值
bG9jYWxob3N0
💡 示例值
bG9jYWxob3N0
🧩 模板变量
theme.config?.global?.target_url
ℹ️ 补充信息
请参照开启仅允许使用指定域名访问进行配置。
跳转后是否保留路径和查询参数
🎯 用途
设定跳转后是否保留路径和查询参数。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.global?.is_keep_path_and_query
ℹ️ 补充信息
请参照开启仅允许使用指定域名访问进行配置。
假设用户访问的链接为 http://localhost/a/b?a=1，目标链接设定为（Base 64 编码前）https://p.com：
- 关闭此项会跳转到：
https://p.com - 开启此项会跳转到：
https://p.com/a/b?a=1
自定义资源位置地址
🎯 用途
指定资源将使用自定义的资源位置地址，而不是主题默认的地址。
📂 配置项位置
全局 -> 自定义资源位置地址
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.global?.is_custom_resource_locations
instant.page 支持
🎯 用途
自动加载 instant.page 脚本，预加载链接以提升页面加载速度。
📂 配置项位置
全局 -> instant.page 支持
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.global?.is_instant_page_enable
Mermaid 支持
🎯 用途
启用 Mermaid 图表渲染功能，支持在文章中绘制流程图、时序图等。
📂 配置项位置
全局 -> Mermaid 支持
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.global?.is_mermaid_enable
ℹ️ 补充信息
明暗切换
启用后需要配置以下子项：
- Mermaid CSS 选择器（默认：
.content .mermaid） - Mermaid 脚本地址（默认：
https://registry.npmmirror.com/mermaid/11.4.1/files/dist/mermaid.esm.min.mjs） - Mermaid Config 属性（默认：
{ startOnLoad: false }）
总体样式
启用自定义字体文件
🎯 用途
使用上传的自定义字体文件替换默认字体。
📂 配置项位置
总体样式 -> 启用自定义字体文件
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_custom_font_files_enable
自定义字体文件
🎯 用途
用于选择上传的字体文件替换默认字体文件。支持 .woff2/.woff/.ttf/.otf/.eot/.ttc/.otc/.sfnt 格式的字体文件。
🏷️ 类型
附件
🧩 模板变量
theme.config?.styles?.custom_font_files
自定义字体名称
🎯 用途
正确填写此项后，如果用户本地安装已经此字体，则应用本地版本。
若此项置空，则即使用户本地已安装该字体，也不会使用本地版本，而是从网络下载字体文件。
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
My Custom Font Regular、MyCustomFont-Regular
外部约束
对应字体文件内部声明的“字体全名 (nameID=4)”或“PostScript 名 (nameID=6)”。
🧩 模板变量
theme.config?.styles?.custom_font_name
配色方案
🎯 用途
设置网站的整体配色方案，支持多种内置主题和自定义配色。
📂 配置项位置
总体样式 -> 配色方案
🏷️ 类型
选项
⭐ 默认值
跟随系统 - 绿（内部值 { theme: "auto", color-scheme: "auto" }）
💡 其余选项
浅色 - 绿（内部值{ theme: "light", color-scheme: "light" }）暗色 - 绿（内部值{ theme: "dark", color-scheme: "dark" }）跟随系统 - 蓝（内部值{ theme: "auto", color-scheme: "auto" }）浅色 - 蓝（内部值{ theme: "auto-blue", color-scheme: "light" }）暗色 - 蓝（内部值{ theme: "dark-blue", color-scheme: "dark" }）浅色 - 灰粉（内部值{ theme: "gray", color-scheme: "light" }）自定义配色（内部值{ theme: "custom", color-scheme: "auto" }）
🧩 模板变量
theme.config?.styles?.color_schema
自定义配色方案
🎯 用途
设置自定义配色方案。
📂 配置项位置
总体样式 -> 自定义配色方案
🏷️ 类型
重复器
⭐ 默认值
📂 配置项名
自定义配色方案识别码
🏷️ 类型
数字
⭐ 默认值
1
ℹ️ 补充信息
唯一识别码，请勿重复。
📂 配置项名
主题色彩模式
🏷️ 类型
选项
⭐ 默认值
深色模式（内部值 dark）
💡 其余选项
浅色模式（内部值light）自动模式（内部值auto）
📂 配置项名
CSS 原始输出模式
🏷️ 类型
布尔值
⭐ 默认值
false
ℹ️ 补充信息
关闭此项后，仅需填写自定义 CSS 变量的部分。
输出时会自动输出在对应 CSS 选择器中（选择器为 html[theme="theme-{识别码}"]）。
📂 配置项名
自定义 CSS 变量
🏷️ 类型
代码输入框（CSS）
⭐ 默认值
--color-accent-1: #2bbc8a;
--color-accent-2: #eee;
--color-accent-3: #ccc;
--color-border: #908d8d;
--color-divide: #616161;
--color-footer-mobile-1: #a4a3a3;
--color-footer-mobile-2: #27292b;
--color-footer-mobile-3: #212326;
--color-quote: #ccffb6;
--color-scrollbar: #999;
--color-text: #d5d7d8;
--toc-level-2: #e3e3e3;
--toc-level-3: #b0b0b0;
--toc-level-4: #636363;
--color-avatar-border: #212326;
--color-background: #1d1f21;
--color-background-code: #212326;
--color-background-numbers: 29, 31, 33;
--color-card-hover: #212326;
--color-card-hover-numbers: 33, 35, 38;
--color-link-hover: #d480aa;
--color-link-hover-70-alpha: rgba(212,128,170,0.7);
comment-widget {
--halo-comment-widget-component-form-input-bg-color: #1d1f21 !important;
--halo-comment-widget-component-form-input-border-color: #636363 !important;
}⚠️ 外部约束
开启 CSS 原始输出模式 时，你填写的内容需要是合法的 CSS 代码。
关闭 CSS 原始输出模式 时，以下内容需要是合法的 CSS 代码：
html[theme="theme-{识别码}"] {
/* 你填写的内容 */
}深浅色模式切换按钮
🎯 用途
若启用此项，将在大标题旁显示明暗模式切换按钮。
切换逻辑为：浅色模式 -> 深色模式 -> 自动模式 -> 浅色模式。
📂 配置项位置
总体样式 -> 深浅色模式切换按钮
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_show_color_scheme_toggle_button
ℹ️ 补充信息
“自动模式配色方案”选择与“浅色模式配色方案”相同即可禁用自动模式。
切换逻辑将变为：浅色模式 -> 深色模式 -> 浅色模式。
启用后可配置：
相关说明：
自动模式配色方案
🎯 用途
设置深浅色模式切换按钮中自动模式的配色方案。
🏷️ 类型
选项
⭐ 默认值
跟随系统 - 绿（内部值 auto）
💡 其余选项
浅色 - 绿（内部值light）暗色 - 绿（内部值dark）跟随系统 - 蓝（内部值auto-blue）浅色 - 蓝（内部值light-blue）暗色 - 蓝（内部值dark-blue）浅色 - 灰粉（内部值gray）自定义配色（内部值custom）
🧩 模板变量
theme.config?.styles?.theme_auto
ℹ️ 补充信息
选择“自定义配色”时，需要配合自定义配色方案使用，并填写自定义配色方案识别码。
浅色模式配色方案
🎯 用途
设置深浅色模式切换按钮中浅色模式的配色方案。
🏷️ 类型
选项
⭐ 默认值
浅色 - 绿（内部值 light）
💡 其余选项
跟随系统 - 绿（内部值auto）暗色 - 绿（内部值dark）跟随系统 - 蓝（内部值auto-blue）浅色 - 蓝（内部值light-blue）暗色 - 蓝（内部值dark-blue）浅色 - 灰粉（内部值gray）自定义配色（内部值custom）
🧩 模板变量
theme.config?.styles?.theme_light
ℹ️ 补充信息
选择"自定义配色"时，需要配合自定义配色方案使用，并填写自定义配色方案识别码。
深色模式配色方案
🎯 用途
设置深浅色模式切换按钮中深色模式的配色方案。
🏷️ 类型
选项
⭐ 默认值
暗色 - 绿（内部值 dark）
💡 其余选项
跟随系统 - 绿（内部值auto）浅色 - 绿（内部值light）跟随系统 - 蓝（内部值auto-blue）浅色 - 蓝（内部值light-blue）暗色 - 蓝（内部值dark-blue）浅色 - 灰粉（内部值gray）自定义配色（内部值custom）
🧩 模板变量
theme.config?.styles?.theme_dark
ℹ️ 补充信息
选择"自定义配色"时，需要配合自定义配色方案使用，并填写自定义配色方案识别码。
字体大小
🎯 用途
设置网站的整体字体大小。
📂 配置项位置
总体样式 -> 字体大小
🏷️ 类型
选项
⭐ 默认值
小字体（内部值 small）
💡 其余选项
常规（内部值normal）大字体（内部值large）
🧩 模板变量
theme.config?.styles?.text_size
自定义内容区域最大宽度
🎯 用途
是否定义内容区域最大宽度。
📂 配置项位置
总体样式 -> 自定义内容区域最大宽度
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_max_width_settings
ℹ️ 补充信息
若关闭此项，内容区域最大宽度会随着页面宽度变化而变化，但可能出现内容整体偏左的现象。
若想关闭此项，建议开启"内容区域最小宽度"和"自定义内容区域宽度属性"。
启用后可配置：
内容区域最大宽度
🎯 用途
设置内容区域的最大宽度。
🏷️ 类型
字符串
⭐ 默认值
48rem
💡 示例值
20rem、300px、30vw
⚠️ 外部约束
合法的 CSS 长度单位。
🧩 模板变量
theme.config?.styles?.max_width
自定义内容区域最小宽度
🎯 用途
是否定义内容区域最小宽度。
📂 配置项位置
总体样式 -> 自定义内容区域最小宽度
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_min_width_settings
内容区域最小宽度
🎯 用途
设置内容区域的最小宽度。
🏷️ 类型
字符串
⭐ 默认值
48rem
💡 示例值
20rem、300px、30vw
⚠️ 外部约束
合法的 CSS 长度单位。
🧩 模板变量
theme.config?.styles?.min_width
强制应用内容区域最小宽度
🎯 用途
控制是否强制应用内容区域最小宽度。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_force_min_width_settings
ℹ️ 补充信息
- 禁用时：当窗口宽度小于设定的最小宽度时，实际会使用窗口宽度。以避免出现横向滚动条。
- 启用时：强制使内容显示区域不小于设定的最小宽度，即使出现横向滚动条。
自定义内容区域宽度属性
🎯 用途
是否定义内容区域宽度属性。
📂 配置项位置
总体样式 -> 自定义内容区域宽度属性
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_content_width_style_settings
内容区域宽度样式
🎯 用途
决定内容区域宽度样式。
🏷️ 类型
字符串
⭐ 默认值
fit-content
💡 示例值
max-content、min-content
⚠️ 外部约束
符合文档对值的要求。
🧩 模板变量
theme.config?.styles?.content_width_style
ℹ️ 补充信息
默认值效果为：使内容区域宽度等于最宽的内容的宽度。（此项实际是在设置内容区域的 width 属性对应的样式值）
页眉头像显示
🎯 用途
控制是否在页眉显示头像。
📂 配置项位置
总体样式 -> 是否显示页眉头像
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_show_header_icon
自定义页眉头像
🎯 用途
用于选择上传的图片作为页眉头像。未设置将使用默认头像 /themes/howiehz-higan/images/logo.{avif,webp,png}。
🏷️ 类型
附件
🧩 模板变量
theme.config?.styles?.icon
圆形头像
🎯 用途
控制是否强制将头像裁切为圆形。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.avatar_circle
灰度头像
🎯 用途
控制是否强制将头像以灰度处理。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.avatar_grayout
额外菜单项
🎯 用途
控制是否在菜单显示额外菜单项。
📂 配置项位置
总体样式 -> 额外菜单项
🏷️ 类型
重复器
⭐ 默认值
包含一个预设：搜索（需搜索组件插件）。
💡 示例值
📂 配置项名
菜单项类型
🏷️ 类型
选项
⭐ 默认值
搜索（需搜索组件插件）（内部值 search）
💡 其余选项
- 随机文章（内部值
random） - 用户账号（内部值
user）
🔒 内部约束
必填项
ℹ️ 补充信息
对于用户账号类型：
- 未登录时，菜单显示
登录，点击后跳转/login页面。 - 已登录时，菜单显示用户名，点击后跳转
/uc页面。
🧩 模板变量
theme.config?.styles?.extra_menu_items
显示页眉菜单
🎯 用途
控制是否显示页眉菜单。
📂 配置项位置
总体样式 -> 显示页眉菜单
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_show_header_menu
显示页码
🎯 用途
控制是否显示页码。
📂 配置项位置
总体样式 -> 显示页码
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_show_page_number
页面底部站点统计信息
🎯 用途
控制是否显示页面底部站点统计信息。
📂 配置项位置
总体样式 -> 页面底部站点统计信息
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_footer_site_stats_show
统计项设置
🎯 用途
设定统计项。
🏷️ 类型
重复器
⭐ 默认值
包含多个预设分享按钮：总阅读量、总文章数、总点赞数、总评论数、总分类数、总字数（需API 扩展包插件）。
💡 示例值
📂 配置项名
统计项
🏷️ 类型
选项
⭐ 默认值
总阅读量（内部值 visit）
💡 其余选项
- 总文章数（内部值
post） - 总点赞数（内部值
upvote） - 总评论数（内部值
comment） - 总分类数（内部值
category） - 总字数（内部值
wordcount）
🔒 内部约束
必填项
📂 配置项名
多语言文本包裹数字
🏷️ 类型
布尔值
⭐ 默认值
true
📂 配置项名
文字左侧的图标
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'%3E%3Cpath fill='%23000' d='M23 10a2 2 0 0 0-2-2h-6.32l.96-4.57c.02-.1.03-.21.03-.32c0-.41-.17-.79-.44-1.06L14.17 1L7.59 7.58C7.22 7.95 7 8.45 7 9v10a2 2 0 0 0 2 2h9c.83 0 1.54-.5 1.84-1.22l3.02-7.05c.09-.23.14-.47.14-.73zM1 21h4V9H1z'/%3E%3C/svg%3E")
⚠️ 外部约束
- 值必须是合法的 CSS
url(...)格式，支持以下三种常见形式：- 内联 SVG（data URI，百分号编码）：
url("data:image/svg+xml,%3Csvg...%3E") - 内联 SVG（data URI，Base64 编码）：
url("data:image/svg+xml;base64,PHN2ZyB4bWxucz0i...") - 外部 SVG 文件链接：
url("/upload/myicon.svg")（需在后台附件管理上传svg格式文件后引用）
- 内联 SVG（data URI，百分号编码）：
获取方法请见教程：自定义图标。
页面底部主题信息
🎯 用途
控制是否显示页面底部主题信息。
📂 配置项位置
总体样式 -> 页面底部主题信息
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_footer_theme_info_show
页面底部主题信息所展示的主题名
🎯 用途
设定页面底部主题信息所展示的主题名。
🏷️ 类型
选项
⭐ 默认值
Higan Haozi（内部值 Higan Haozi）
💡 其余选项
- Higan（内部值
Higan） - 彼岸（内部值
彼岸）
🧩 模板变量
theme.config?.styles?.footer_theme_info_theme_name
页面底部主题信息所展示的 Halo 版本
🎯 用途
设定页面底部主题信息所展示的 Halo 版本。
🏷️ 类型
选项
⭐ 默认值
Halo（内部值 Halo）
💡 其余选项
- Halo Pro（内部值
Halo Pro） - Halo 专业版（内部值
Halo 专业版）
🧩 模板变量
theme.config?.styles?.footer_theme_info_halo_version_name
页面底部版权信息
🎯 用途
控制是否显示页面底部版权信息。
📂 配置项位置
总体样式 -> 页面底部版权信息
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_footer_copyright_show
版权信息自定义署名
🎯 用途
设定页面底部版权信息的署名。
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
HowieHz
🧩 模板变量
theme.config?.styles?.footer_copyright_custom_name
强制页脚、页码在页面底部
🎯 用途
控制是否强制页脚、页码在页面底部。
📂 配置项位置
总体样式 -> 强制页脚、页码在页面底部
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_footer_force_bottom
页面底部菜单
🎯 用途
控制是否显示页面底部菜单。
📂 配置项位置
总体样式 -> 页面底部菜单
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_footer_menu_show
添加内容到页面最底部
🎯 用途
控制添加内容到页面最底部。
📂 配置项位置
总体样式 -> 添加内容到页面最底部
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_footer_content_show
页面最底部内容
🎯 用途
设定页面最底部内容内容。
🏷️ 类型
代码输入框（HTML）
⭐ 默认值
空
💡 示例值
已经结束了！HTML 代码也是可以的：
<code>下面已经没有东西了</code>⚠️ 外部约束
合法的 HTML 代码。
🧩 模板变量
theme.config?.styles?.footer_content
多语言页面最底部内容支持
🎯 用途
控制是否启用多语言页面最底部内容支持。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_18n_footer_content_show
ℹ️ 补充信息
启用后请参照多语言页面最底部内容使用指南进行配置
自定义多语言页面最底部内容
🎯 用途
设定多语言页面最底部内容内容。
🏷️ 类型
重复器
⭐ 默认值
📂 配置项名
语言代码
🏷️ 类型
字符串
⭐ 默认值
zh
💡 示例值
zh、zh-CN、zh-Hans、en、en-US
🔒 内部约束
必填项
⚠️ 外部约束
设定值需满足 BCP 47，否则无效。
📂 配置项名
页面最底部内容
🏷️ 类型
代码输入框（HTML）
⭐ 默认值
空
💡 示例值
已经结束了！HTML 代码也是可以的：
<code>下面已经没有东西了</code>⚠️ 外部约束
合法的 HTML 代码。
🧩 模板变量
theme.config?.styles?.i18n_footer_content
为三级标题添加下划线
🎯 用途
启用时，在三级标题（h3）下方显示下划线装饰，让标题更加突出。
📂 配置项位置
总体样式 -> 为三级标题添加下划线
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_h3_underline
引用块保留空行
🎯 用途
在引用块中保留空行，否则将自动删除引用块中的空行。
📂 配置项位置
总体样式 -> 引用块保留空行
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_preserve_empty_lines_in_blockquote
ℹ️ 补充信息
引用块写法请参考写作样式。
引用块前添加引号
🎯 用途
在引用块前添加引号。
📂 配置项位置
总体样式 -> 引用块前添加引号
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.styles?.is_show_the_quote_before_blockquote
引用块后添加引号
🎯 用途
在引用块后添加引号。
📂 配置项位置
总体样式 -> 引用块后添加引号
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_show_the_quote_after_blockquote
表格行间线（除表头）
🎯 用途
是否为表格每行底部添加表格线（除表头）。
📂 配置项位置
总体样式 -> 表格行间线（除表头）
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.styles?.is_show_the_table_bottom_border
表格行间线宽度（除表头）
🎯 用途
设置表格每行底部添表格线的宽度（除表头）。
🏷️ 类型
字符串
⭐ 默认值
8px
💡 示例值
0px、5px、10%、1rem
⚠️ 外部约束
合法的 CSS 长度单位。
🧩 模板变量
theme.config?.styles?.table_bottom_border_width
标题上边距倍率
🎯 用途
设置标题的上边距 (margin-top) 倍率。
📂 配置项位置
总体样式 -> 标题上边距倍率
🏷️ 类型
浮点数/整数
⭐ 默认值
1
💡 示例值
0.5、1、1.5、2
🔒 内部约束
值范围为 0-5
🧩 模板变量
theme.config?.styles?.heading_margin_top_multiplier
ℹ️ 补充信息
值为 1 表示使用默认边距，小于 1 减小边距，大于 1 增加边距。
标题下边距倍率
🎯 用途
设置标题的下边距 (margin-bottom) 倍率。
📂 配置项位置
总体样式 -> 标题下边距倍率
🏷️ 类型
浮点数/整数
⭐ 默认值
1
💡 示例值
0.5、1、1.5、2
🔒 内部约束
值范围为 0-5
🧩 模板变量
theme.config?.styles?.heading_margin_bottom_multiplier
段落上边距倍率
🎯 用途
设置段落的上边距倍率。
📂 配置项位置
总体样式 -> 段落上边距倍率
🏷️ 类型
浮点数/整数
⭐ 默认值
1
💡 示例值
0.5、1、1.5、2
🔒 内部约束
值范围为 0-5
🧩 模板变量
theme.config?.styles?.paragraph_margin_top_multiplier
段落下边距倍率
🎯 用途
设置段落的下边距倍率。
📂 配置项位置
总体样式 -> 段落下边距倍率
🏷️ 类型
浮点数/整数
⭐ 默认值
1
💡 示例值
0.5、1、1.5、2
🔒 内部约束
值范围为 0-5
🧩 模板变量
theme.config?.styles?.paragraph_margin_bottom_multiplier
首页样式
应用范围：/(page/{page})。
主页 HTML 标题
🎯 用途
自定义主页的 HTML 标题（会显示在浏览器标签页上）。
📂 配置项位置
首页样式 -> 主页 HTML 标题
🏷️ 类型
字符串
⭐ 默认值
空
⚠️ 外部约束
如果配置值过长，可能影响 SEO 和页面显示效果。
🧩 模板变量
theme.config?.index_styles?.page_html_title
ℹ️ 补充信息
如置空则取值 Halo CMS 的后台（快速跳转）设定的站点标题。
一言（hitokoto）
🎯 用途
是否在首页显示一言（hitokoto）随机句子服务的内容。
📂 配置项位置
首页样式 -> 一言（hitokoto）
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.index_styles?.hitokoto
自定义随机显示一句话
🎯 用途
是否在首页随机显示一句话。
📂 配置项位置
首页样式 -> 自定义随机显示一句话
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.index_styles?.is_random_sentence_show
ℹ️ 补充信息
启用后可以配置
- 自定义句子内容
个人简介/公告栏
🎯 用途
在首页显示个人简介或公告栏内容。
📂 配置项位置
首页样式 -> 个人简介/公告栏
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.index_styles?.is_resume_show
ℹ️ 补充信息
启用后可以配置
- 个人简介/公告栏内容
- 多语言个人简介/公告栏支持
- 自定义多语言公告栏内容
多语言个人简介/公告栏支持
🎯 用途
控制是否启用多语言个人简介/公告栏支持。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.index_styles?.is_i18n_resume_show
ℹ️ 补充信息
启用后请参照多语言个人简介/公告栏使用指南进行配置
自定义多语言公告栏内容
🎯 用途
设定多语言公告栏内容。
🏷️ 类型
重复器
⭐ 默认值
📂 配置项名
语言代码
🏷️ 类型
字符串
⭐ 默认值
zh
💡 示例值
zh、zh-CN、zh-Hans、en、en-US
🔒 内部约束
必填项
⚠️ 外部约束
设定值需满足 BCP 47，否则无效。
📂 配置项名
个人简介/公告栏内容
🏷️ 类型
代码输入框（HTML）
⭐ 默认值
空
💡 示例值
欢迎大家访问此站点！HTML 代码也是可以的：
<code>支持填写 HTML 代码</code>⚠️ 外部约束
合法的 HTML 代码。
🧩 模板变量
theme.config?.index_styles?.i18n_resume
社交资料图标左侧文字
🎯 用途
控制是否显示首页社交资料图标左侧的文字。
📂 配置项位置
首页样式 -> 社交资料图标左侧文字
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_find_me_left_text
首页文章列表标题
🎯 用途
控制是否显示首页文章列表的标题。
📂 配置项位置
首页样式 -> 首页文章列表标题
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_index_post_list_title
主页列表布局
🎯 用途
选择首页的文章列表显示样式。
📂 配置项位置
首页样式 -> 主页列表布局
🏷️ 类型
选项
⭐ 默认值
简洁文章列表（内部值 simple-post-list）
💡 其余选项
- 多元文章列表（内部值
post-list-summary） - 瞬间列表（内部值
moment-list-summary）
🧩 模板变量
theme.config?.index_styles?.list_layout
简洁列表显示文章阅读量
🎯 用途
控制是否在简洁列表中显示文章阅读量。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.index_styles?.is_show_post_views_in_simple_post_list
多元列表显示文章分类
🎯 用途
控制是否在多元列表中显示文章分类。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_post_categories_in_post_list_summary
多元列表显示文章标签
🎯 用途
控制是否在多元列表中显示文章标签。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_post_tags_in_post_list_summary
多元列表显示文章阅读量
🎯 用途
控制是否在多元列表中显示文章阅读量。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_post_views_in_post_list_summary
多元列表显示文章预计阅读时间
🎯 用途
控制是否在多元列表中显示文章预计阅读时间。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.index_styles?.is_show_post_estimated_reading_time_in_post_list_summary
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
多元列表显示文章字数统计
🎯 用途
控制是否在多元列表中显示文章字数统计。
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.index_styles?.is_show_post_word_count_in_post_list_summary
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
多元列表显示文章摘要
🎯 用途
控制是否在多元列表中显示文章摘要。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_post_excerpt_in_post_list_summary
多元列表文章摘要行数上限
🎯 用途
设置多元列表中文章摘要的最大行数。
🏷️ 类型
整数
⭐ 默认值
3
🔒 内部约束
范围 1-5
🧩 模板变量
theme.config?.index_styles?.post_excerpt_max_lines
多元列表跳转文章链接所用提示文字
🎯 用途
控制是否在多元列表中显示跳转文章链接的提示文字。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_index_post_list_permalink_text
ℹ️ 补充信息
如关闭此项，首页文章列表文章项将不显示跳转链接文字
多元列表显示文章封面
🎯 用途
控制是否在多元列表中显示文章封面。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_post_cover_in_post_list_summary
瞬间列表显示条数
🎯 用途
设置瞬间列表中显示的条目数量。
🏷️ 类型
整数
⭐ 默认值
10
🧩 模板变量
theme.config?.index_styles?.moment_list_page_size
瞬间列表显示条目作者头像
🎯 用途
控制是否在瞬间列表中显示条目作者头像。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_moment_avatar
瞬间列表显示条目作者昵称
🎯 用途
控制是否在瞬间列表中显示条目作者昵称。
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_show_moment_nickname
文章列表置顶图标
🎯 用途
在文章列表中为置顶文章显示特殊图标。
📂 配置项位置
首页样式 -> 文章列表置顶图标
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.index_styles?.is_pin_icon_show
ℹ️ 补充信息
启用后可以配置
- 置顶图标的位置（标题左侧或右侧），默认为右侧。
文章页样式
应用范围：/archives/{slug}。
优化文章段落空行显示
🎯 用途
为文章内容段落添加最小高度，以显示空行。
📂 配置项位置
文章页样式 -> 优化文章段落空行显示
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_optimize_content_paragraph_spacing
ℹ️ 补充信息
不同 Markdown 编辑器所用解析器不同，故此配置项反映到最终渲染结果上，可能会有所不同。
相关链接：babelmark3 是一个对比不同 Markdown 解析器解析结果的网站。
文档段落首行缩进
🎯 用途
为文章内容段落首行添加缩进样式。
📂 配置项位置
文章页样式 -> 段落首行缩进
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_enable_paragraph_first_line_indent
ℹ️ 补充信息
启用后可以配置
- 首行缩进值
- 类型：字符串
- 默认值：
2em（2 字符宽度） - 外部约束：CSS 长度单位。如：20rem, 300px, 30vw。
文章标题大写
🎯 用途
将文章标题中字符转换为对应大写表示。
如：a 转换为 A。
📂 配置项位置
文章页样式 -> 文章标题大写
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.post_title_uppper
文章发布时间
🎯 用途
在文章页面顶部显示文章的发布时间。
📂 配置项位置
文章页样式 -> 文章发布时间
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.post_styles?.is_show_post_publish_time
ℹ️ 补充信息
启用后可以配置
- 文章发布时间左侧文字
文章更新时间
🎯 用途
在文章页面顶部显示文章的最后更新时间。
📂 配置项位置
文章页样式 -> 文章更新时间
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_show_post_updated_time
ℹ️ 补充信息
启用后可以配置
- 文章更新时间左侧文字
文章阅读量
🎯 用途
在文章页面显示文章的阅读量统计。
📂 配置项位置
文章页样式 -> 文章阅读量
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.post_styles?.is_show_post_views
文章预计阅读时间
🎯 用途
在文章页面显示根据文章字数估算的阅读时间。
📂 配置项位置
文章页样式 -> 文章预计阅读时间
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_show_post_estimated_reading_time
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
文章字数统计
🎯 用途
在文章页面显示文章的总字数。
📂 配置项位置
文章页样式 -> 文章字数统计
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_show_post_word_count
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
桌面端菜单中的分享按钮
🎯 用途
控制是否在桌面端文章页面的菜单中显示分享按钮。
📂 配置项位置
文章页样式 -> 桌面端菜单中的分享按钮
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.post_styles?.is_show_post_nav_share_button
自定义侧边目录最大宽度
🎯 用途
开启后可以配置
- 文章页面右侧边栏目录的最大宽度。
📂 配置项位置
文章页样式 -> 自定义侧边目录最大宽度
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_custom_toc_max_width
ℹ️ 补充信息
启用后可以配置
- 侧边目录最大宽度
- 类型：字符串
- 默认值：
20rem - 外部约束：CSS 长度单位。如：20rem, 300px, 30vw。
文章末尾的的分隔线
🎯 用途
控制是否显示文章末尾的的分隔线。
📂 配置项位置
文章页样式 -> 文章末尾的的分隔线
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.post_styles?.is_dividing_line_at_the_end_of_post_show
文章底部的点赞按钮
🎯 用途
控制是否显示文章底部的点赞按钮。
📂 配置项位置
文章页样式 -> 文章底部的点赞按钮
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_post_upvote_button_show
ℹ️ 补充信息
启用后可以配置
- 点赞按钮宽度
- 类型：字符串
- 默认值：
1rem - 外部约束：CSS 长度单位。如：20rem, 300px, 30vw。
- 点赞按钮高度
- 类型：字符串
- 默认值：
1rem - 外部约束：CSS 长度单位。如：20rem, 300px, 30vw。
- 展示文章获赞数
- 点赞按钮位置
文章底部的推荐文章
🎯 用途
控制是否在文章底部显示推荐文章列表。
原理：读取当前文章第一个分类，并且随机输出其中若干个文章。
📂 配置项位置
文章页样式 -> 文章底部的推荐文章
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_post_recommended_articles_show
ℹ️ 补充信息
如果当前文章在随机列表中将会被剔除，因此实际推荐文章数可能小于设定的“推荐文章数量”。
如果当前文章未设置分类，该功能会被禁用。
如果分类仅有一篇文章，该功能会被禁用。
启用后可以配置
- 推荐文章数量
文章底部的相邻文章导航
🎯 用途
开启后将在文章底部显示上一篇和下一篇文章的导航链接。
📂 配置项位置
文章页样式 -> 文章底部的相邻文章导航
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.post_styles?.is_post_prev_next_navigation_show
文章评论区
🎯 用途
控制是否在文章页面显示评论区。
📂 配置项位置
文章页样式 -> 文章评论区
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.post_styles?.is_post_comment_section_show
移动端底部导航栏
🎯 用途
控制是否在移动端文章页面底部显示导航栏。
📂 配置项位置
文章页样式 -> 移动端底部导航栏
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.post_styles?.is_show_footer_nav
ℹ️ 补充信息
启用后可以配置
- 移动端底部导航栏中的分享按钮
分类集合页样式
应用范围：/categories。
显示每个分类下的文章数量
🎯 用途
控制是否在分类列表中显示每个分类包含的文章数量。
📂 配置项位置
分类集合页样式 -> 显示每个分类下的文章数量
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.categories_page_styles?.is_show_the_number_of_articles_per_category
ℹ️ 补充信息
启用后可以配置
- 在文章数量左侧的字符
- 类型：字符串
- 默认值：
(
- 在文章数量右侧的字符
- 类型：字符串
- 默认值：
)
显示多层分类
🎯 用途
控制是否在分类页面展示子分类。
📂 配置项位置
分类集合页样式 -> 是否显示多层分类
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.categories_page_styles?.is_show_multi_layer_categories
分类详情页样式
应用范围：/categories/{slug}。
分类详情页文章列表显示文章阅读量
🎯 用途
在分类详情页显示文章阅读量。
📂 配置项位置
分类详情页样式 -> 文章列表显示文章阅读量
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.category_page_styles?.is_show_post_views_in_post_list
显示分类 RSS 订阅按钮
🎯 用途
在分类详情页显示 RSS 订阅按钮。
📂 配置项位置
分类详情页样式 -> 分类 RSS 订阅按钮
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.category_page_styles?.is_show_rss_button
⚠️ 外部约束
需 RSS 订阅插件启用后方可使用。
标签集合页样式
应用范围：/tags。
显示每个标签下的文章数量
🎯 用途
控制是否在分类列表中显示每个标签包含的文章数量。
📂 配置项位置
标签集合页样式 -> 显示每个标签下的文章数量
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.tags_page_styles?.is_show_the_number_of_posts_per_tag
📂 配置项位置
标签集合页样式 -> 标签排序方式
🏷️ 类型
选项
⭐ 默认值
默认（内部值 default）
💡 其余选项
- 按文章数量从多到少（内部值
count_desc） - 按文章数量从少到多（内部值
count_asc） - 按名称升序（内部值
name_asc） - 按名称降序（内部值
name_desc）
🧩 模板变量
theme.config?.tags_page_styles?.tags_sort_order
标签详情页样式
应用范围：/tags/{slug}。
标签详情页文章列表显示文章阅读量
🎯 用途
在标签详情页显示文章阅读量。
📂 配置项位置
标签详情页样式 -> 文章列表显示文章阅读量
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.tag_page_styles?.is_show_post_views_in_post_list
显示标签 RSS 订阅按钮
🎯 用途
在标签详情页显示 RSS 订阅按钮。
📂 配置项位置
标签详情页样式 -> 显示标签 RSS 订阅按钮
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.tag_page_styles?.is_show_rss_button
⚠️ 外部约束
需 RSS 订阅插件启用后方可使用。
作者详情页样式
应用范围：/authors/{name}。
显示作者 RSS 订阅按钮
🎯 用途
在作者详情页显示 RSS 订阅按钮。
📂 配置项位置
作者详情页样式 -> 显示作者 RSS 订阅按钮
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.author_page_styles?.is_show_rss_button
⚠️ 外部约束
需 RSS 订阅插件启用后方可使用。
归档页样式
应用范围：/archives(/{year}(/{month}))。
按照发布年份和月份折叠文章列表
🎯 用途
在归档页面中，按照文章发布的年份和月份将文章列表折叠显示。
📂 配置项位置
归档页样式 -> 按照发布年份和月份折叠文章列表
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.archives_page_styles?.is_collapse_post_list_by_publication_year_and_month
ℹ️ 补充信息
启用后可以配置
- 展开折叠动画时长（单位：毫秒）
- 类型：浮点数/整数
- 默认值：
200
自定义页面样式
应用范围：/{slug}。
优化段落空行显示
🎯 用途
为自定义页面内容段落添加最小高度，以显示空行。
📂 配置项位置
自定义页面样式 -> 优化段落空行显示
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.custom_page_styles?.is_optimize_content_paragraph_spacing
ℹ️ 补充信息
不同 Markdown 编辑器所用解析器不同，故此配置项反映到最终渲染结果上，可能会有所不同。
相关链接：babelmark3 是一个对比不同 Markdown 解析器解析结果的网站。
自定义页面段落首行缩进
🎯 用途
为内容段落首行添加缩进样式。
📂 配置项位置
自定义页面样式 -> 段落首行缩进
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.custom_page_styles?.is_enable_paragraph_first_line_indent
ℹ️ 补充信息
启用后可以配置
- 首行缩进值
- 类型：字符串
- 默认值：
2em（2 字符宽度） - 外部约束：CSS 长度单位。如：20rem, 300px, 30vw。
页面预计阅读时间
🎯 用途
在页面显示根据文章字数估算的阅读时间。
📂 配置项位置
自定义页面样式 -> 页面预计阅读时间
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.custom_page_styles?.is_show_post_estimated_reading_time
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
页面字数统计
🎯 用途
在页面显示文章的总字数。
📂 配置项位置
自定义页面样式 -> 页面字数统计
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.custom_page_styles?.is_show_post_word_count
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
页面正文内容末尾分隔线
🎯 用途
控制是否显示页面正文内容末尾的的分隔线。
📂 配置项位置
自定义页面样式 -> 页面正文内容末尾分隔线
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.custom_page_styles?.is_dividing_line_at_the_end_of_content_show
页面评论区
🎯 用途
控制是否在页面显示评论区。
📂 配置项位置
自定义页面样式 -> 页面评论区
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.custom_page_styles?.is_custom_page_comment_section_show
图库页样式
需图库管理插件启用后方可使用。
图片圆角宽度
🎯 用途
设置相册页面中图片的圆角宽度。
📂 配置项位置
相册页样式 -> 图片圆角宽度
🏷️ 类型
字符串
⭐ 默认值
8px
💡 示例值
0px、5px、10%、1rem
⚠️ 外部约束
合法的 CSS 长度单位。
🧩 模板变量
theme.config?.photos_styles?.img_border_radius
图片渐入动画时间
🎯 用途
设置相册页面中图片渐入动画时间。
📂 配置项位置
相册页样式 -> 图片渐入动画时间
🏷️ 类型
整数/浮点数（单位：秒）
⭐ 默认值
0.2
💡 示例值
1、0
🧩 模板变量
theme.config?.photos_styles?.img_transition_duration_after_load
启用瀑布流布局
🎯 用途
在相册页面使用瀑布流布局展示图片。
📂 配置项位置
相册页样式 -> 启用瀑布流布局
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.photos_styles?.is_enable_masonry_layout
ℹ️ 补充信息
启用后可以配置
- 瀑布流最大列数
- 瀑布流最小列数
- 瀑布流最小图片宽度
- 瀑布流间隔宽度
- 进阶配置选项
- 自定义图片 onmouseover 属性
- 自定义图片 onmouseout 属性
禁用后可以配置
- 显示分组标题
瞬间页样式
需瞬间管理插件启用后方可使用。
帖文预计阅读时间
🎯 用途
在帖子开头显示根据字数估算的阅读时间。
📂 配置项位置
瞬间页样式 -> 帖文预计阅读时间
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.moments_styles?.is_show_post_estimated_reading_time
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
帖文字数统计
🎯 用途
在帖子开头显示文章的总字数。
📂 配置项位置
瞬间页样式 -> 帖文字数统计
🏷️ 类型
布尔值
⭐ 默认值
false
🧩 模板变量
theme.config?.moments_styles?.is_show_post_word_count
ℹ️ 补充信息
启用 API 拓展插件后将自动启用更准确的计量方法。
瞬间页点赞按钮
🎯 用途
在瞬间页面显示点赞按钮。
📂 配置项位置
瞬间页样式 -> 启用点赞按钮
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.moments_styles?.is_moment_upvote_button_show
瞬间页评论区
🎯 用途
控制是否在瞬间页面显示评论区。
📂 配置项位置
瞬间页样式 -> 启用评论区
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.moments_styles?.is_moment_comment_section_show
错误页样式
页面自动重定向
🎯 用途
在错误页面（如 404）自动跳转到指定页面。
📂 配置项位置
错误页样式 -> 页面自动重定向
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
theme.config?.error_page_styles?.is_auto_redirect
ℹ️ 补充信息
启用后可以配置
- 跳转目标链接
- 类型：字符串
- 默认值：
/ - 外部约束：合法的相对/绝对链接
- 跳转等待时间（单位：秒）
- 类型：整数
- 默认值：
5
社交资料/RSS
首页社交资料展示
🎯 用途
在首页展示社交媒体链接和 RSS 订阅等资料。
📂 配置项位置
社交资料/RSS -> 首页社交资料展示
🏷️ 类型
数组（可重复添加多个社交资料）
⭐ 默认值
空数组 []
🧩 模板变量
theme.config?.sns?.index_sns
ℹ️ 补充信息
- 支持多种预设社交平台：RSS、BiliBili、Dribbble、Email、Facebook、GitHub、Instagram、QQ、Reddit、Stack Overflow、Telegram、X（Twitter）、YouTube、豆瓣、网易云音乐、微博、知乎等
- 支持自定义社交资料
- 支持纯文本显示
- 可通过"设定自定义资料"配置自己的社交平台
设定自定义资料
🎯 用途
定义自己的社交资料，用于在首页社交资料展示中使用。
📂 配置项位置
社交资料/RSS -> 设定自定义资料
🏷️ 类型
重复器
⭐ 默认值
空
🧩 模板变量
theme.config?.sns?.custom_sns
ℹ️ 补充信息
提供了主流平台的预设值，只需要填写对应平台的识别码就可以添加。
除此之外，你也可以添加自定义资料。
每个自定义资料需要配置：
- 识别码：任意字母、数字、下划线组合（如
myBlog） - 链接：完整的 URL（如
https://example.com） - 图标：CSS
url(...)格式图标代码。获取方法请见教程：自定义图标。 - aria-label：无障碍标签（如
Find me on my blog）
自定义分享按钮
分享按钮设置
🎯 用途
配置文章页面的分享按钮列表，支持多种分享方式。
📂 配置项位置
自定义分享按钮 -> 分享按钮设置
🏷️ 类型
重复器
⭐ 默认值
包含多个预设分享按钮：E-mail、QRCode、Native、Facebook、X、LinkedIn、Pinterest、Telegram、QQ、Weibo、WeChat、Qzone、Douban
🧩 模板变量
theme.config?.share?.button_config
ℹ️ 补充信息
@URL和@TITLE是占位符，使用时会被替换为页面实际地址和标题- 每个分享按钮有四个可配置项：名称、链接、图标、
aria-label（无障碍标签） - 可以自由调整顺序、删除或新增分享按钮
下一步
你可以进一步了解：