Files
halo-theme-WarmIsland/docs/pages/custom-page.md
T
nxxy335 5c7c6325b1 feat(v1.2.7): 全面校准文档并精简三个可选 API 配置项文案
- 文档对齐 1.2.7:feed/RSS 聚合改由官方链接管理插件订阅承担、Halo 要求统一 >=2.27.0、补齐设置分组文档、清理与代码不符的描述,并修复正文引用块留白
- 三个可选 API 设置项 help 只保留功能说明,隐私披露统一由 README「外部资源与隐私」与文档站承载;字段恢复按开关条件显示,修正配置块缩进
- audit:external 改为防回潮检查:字段存在、help 不得出现披露文案、README 必须保留隐私披露章节
2026-11-11 22:34:32 +08:00

2.2 KiB
Raw Permalink Blame History

自定义页面

自定义页面是 Halo 的独立页面功能,用于创建关于、留言板、订阅动态、微信读书等独立内容页面。

使用方式

  1. 进入 Halo 后台 → 页面 → 新建
  2. 填写页面标题和内容
  3. 可选:在「自定义模板」中选择主题提供的模板
  4. 发布页面,并把页面加入导航菜单

页面地址由创建时设定的 slug 决定,主题不为自定义模板提供固定路由。

页面模板

theme.yaml 中注册了 3 个自定义模板,加上默认的 page.html 共 4 种:

模板 模板文件 说明
默认 page.html 标准内容页面
留言板(MessageBoard) page_messageboard.html 带评论的留言墙,标题与副标题可配置
订阅(Subscriptions) page_subscriptions.html 博友文章订阅动态,依赖官方「链接管理」插件的 RSS 订阅
微信读书(WeRead) weread.html 微信读书书架,依赖微信读书插件,访客免登录查看

留言板模板

选择留言板模板后,页面会集成评论组件,访客可以直接留言。标题和副标题在 主题设置 → 留言板 中配置,详见留言板配置。

订阅模板

feed / RSS 聚合不再依赖已停止提供的「朋友圈」插件,而由官方 「链接管理」(PluginLinks)插件的订阅能力提供。使用步骤:

  1. 安装并启用链接管理插件,维护博友链接的 RSS 订阅源
  2. 新建页面,自定义模板选择「订阅」
  3. 在主题设置 → 订阅中调整每页条数、加载方式与布局,详见订阅配置

未安装插件或暂无订阅动态时页面会显示友好提示,不会报错。 完整说明见订阅页面。

微信读书模板

选择「微信读书」模板后展示书架与阅读记录,标题 / 副标题在 主题设置 → 微信读书 中配置,详见微信读书配置。 该页面依赖 Halo 2.27+ 的能力。

页面功能

自定义页面支持:

  • 富文本编辑器内容
  • 封面图
  • 评论组件
  • 自定义模板选择