元数据配置项
提示
当你的站点已经安装了最新版本的主题后，可在下方填写你的站点链接。
即可在本文档启用快速跳转链接。
站点链接
示例
🎯 用途
说明配置项用途。
📂 配置项位置
说明在主题配置项的位置。
⚡ 快速跳转
点击即可快速跳转到对应主题配置项。
🏷️ 类型
此配置项的值类型。
以下举例几个常见类型
- 字符串：一串字符，如
abc123、zh-CN。 - 整数：整数，如
-1、0、100。 - 浮点数：带小数点的数，如
1.2、0.3、4.5。 - 布尔值：
true或false。体现为一个单选框🔘，打勾☑️就是true，不勾🔘就是false。 - 选项：提供了固定选项，直接选择即可。
- 重复器：可重复一组输入。可增加组，移除组，交换任意组顺序。
- 代码输入框（编程语言）：提供一个多行的代码输入框，会按照指定编程语言进行高亮。
💡 示例值
再举几个例子便于理解。
🔒 内部约束
如果填写的配置值不满足这个要求，将无法保存配置。
⚠️ 外部约束
如果填写的配置值不满足这个要求，主题可能无法正常工作。
🧩 模板变量
提供给模板开发者使用的变量，用于读取此配置值。可通过 ${模板变量} 使用。
ℹ️ 补充信息
补充说明一些信息。
文章元数据
如何找到一篇文章元数据的设置位：
- 方法一：进入文章管理页（/console/posts）-> 点击一篇文章右边的三个点 -> 弹出的上下文菜单中选择“设置” -> 拉到底部即可见元数据设置位
- 方法二：进入文章管理页（/console/posts）-> 点击右上角“发布”按钮左侧的“设置”按钮 -> 拉到底部即可见元数据设置位
文章页面标题
🎯 用途
设定文章在浏览页的 HTML 标题。如果配置值为空，则 HTML 标题取文章标题。
📂 配置项位置
文章元数据 -> 页面标题
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
Halo 主题指南
⚠️ 外部约束
如果配置值过长，可能影响 SEO 和页面显示效果。
🧩 模板变量
#annotations.get(post, 'higan.howiehz.top/page-title')
为空时回退为文章标题的写法： #annotations.getOrDefault(post, 'higan.howiehz.top/page-title', post.spec?.title)
文章页面语言
🎯 用途
设定文章在浏览页的页面语言（HTML lang 属性）。如果配置值为空，将按页面语言设定优先级进行回退。
📂 配置项位置
文章元数据 -> 页面语言
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
zh、zh-CN、zh-Hans、en、en-US
⚠️ 外部约束
设定值需满足 BCP 47，否则无效。
🧩 模板变量
#annotations.get(post, 'higan.howiehz.top/page-language')
是否显示在文章列表中
📂 配置项位置
文章元数据 -> 显示在文章列表中
🏷️ 类型
布尔值
⭐ 默认值
true
🧩 模板变量
#annotations.getOrDefault(post, 'higan.howiehz.top/show-in-post-list', 'true')
分类元数据
如何找到一个分类元数据的设置位：
- 进入文章分类管理页（/console/posts/categories）-> 点击一个分类右边的三个点 -> 弹出的上下文菜单中选择“编辑” -> 拉到底部即可见元数据设置位
分类页面标题
🎯 用途
设定分类详情页的 HTML 标题。如果配置值为空，则 HTML 标题取分类名。
📂 配置项位置
分类元数据 -> 页面标题
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
Halo 主题指南
⚠️ 外部约束
如果配置值过长，可能影响 SEO 和页面显示效果。
🧩 模板变量
#annotations.get(category, 'higan.howiehz.top/page-title)
为空时回退为分类名的写法： #annotations.getOrDefault(category, 'higan.howiehz.top/page-title', category.spec?.displayName)
分类页面语言
🎯 用途
设定分类详情页的页面语言（HTML lang 属性）。如果配置值为空，将按页面语言设定优先级进行回退。
📂 配置项位置
分类元数据 -> 页面语言
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
zh、zh-CN、zh-Hans、en、en-US
⚠️ 外部约束
设定值需满足 BCP 47，否则无效。
🧩 模板变量
#annotations.get(category, 'higan.howiehz.top/page-language')
标签元数据
如何找到一个标签元数据的设置位：
- 进入文章标签管理页（/console/posts/tags）-> 点击一个标签右边的三个点 -> 弹出的上下文菜单中选择“编辑” -> 拉到底部即可见元数据设置位
标签页面标题
🎯 用途
设定标签详情页的 HTML 标题。如果配置值为空，则 HTML 标题取标签名。
📂 配置项位置
标签元数据 -> 页面标题
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
Halo 主题指南
⚠️ 外部约束
如果配置值过长，可能影响 SEO 和页面显示效果。
🧩 模板变量
#annotations.get(tag, 'higan.howiehz.top/page-title')
为空时回退为站点标题的写法： #annotations.getOrDefault(tag, 'higan.howiehz.top/page-title', tag.spec?.displayName)
标签页面语言
🎯 用途
设定标签详情页的页面语言（HTML lang 属性）。如果配置值为空，将按页面语言设定优先级进行回退。
📂 配置项位置
标签元数据 -> 页面语言
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
zh、zh-CN、zh-Hans、en、en-US
⚠️ 外部约束
设定值需满足 BCP 47，否则无效。
🧩 模板变量
#annotations.get(tag, 'higan.howiehz.top/page-language')
页面元数据
如何找到一个页面元数据的设置位：
- 方法一：进入页面管理页（/console/single-pages）-> 点击一个页面右边的三个点 -> 弹出的上下文菜单中选择“设置” -> 拉到底部即可见元数据设置位
- 方法二：进入页面管理页（/console/single-pages）-> 进入一个页面的编辑页 -> 点击右上角“发布”按钮左侧的“设置”按钮 -> 拉到底部即可见元数据设置位
自定义模板
文章页样式
🎯 用途
让自定义页面使用类似文章页的布局和样式。
📂 配置项位置
自定义页面样式 -> 自定义模板
ℹ️ 补充信息
启用后，自定义页面将使用类似文章页的布局和样式。 主要体现在：
- 桌面端顶部菜单（侧边目录，回到顶端按钮，分享菜单）
- 移动端底部菜单（折叠目录，回到顶端按钮，分享菜单）
- 以及，菜单、目录相关设置与文章页样式下对应设置保持一致。
页面标题
🎯 用途
设定页面的 HTML 标题。如果配置值为空，则 HTML 标题取页面标题。
📂 配置项位置
页面元数据 -> 页面标题
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
Halo 主题指南
⚠️ 外部约束
如果配置值过长，可能影响 SEO 和页面显示效果。
🧩 模板变量
#annotations.get(singlePage, 'higan.howiehz.top/page-title')
为空时回退为站点标题的写法： #annotations.getOrDefault(singlePage, 'higan.howiehz.top/page-title', singlePage.spec?.title)
页面语言
🎯 用途
设定页面语言（HTML lang 属性）。如果配置值为空，将按页面语言设定优先级进行回退。
📂 配置项位置
页面元数据 -> 页面语言
🏷️ 类型
字符串
⭐ 默认值
空
💡 示例值
zh、zh-CN、zh-Hans、en、en-US
⚠️ 外部约束
设定值需满足 BCP 47，否则无效。
🧩 模板变量
#annotations.get(post, 'higan.howiehz.top/page-language')