feat(v1.2.7): 全面校准文档并精简三个可选 API 配置项文案

- 文档对齐 1.2.7:feed/RSS 聚合改由官方链接管理插件订阅承担、Halo 要求统一 >=2.27.0、补齐设置分组文档、清理与代码不符的描述,并修复正文引用块留白
- 三个可选 API 设置项 help 只保留功能说明,隐私披露统一由 README「外部资源与隐私」与文档站承载;字段恢复按开关条件显示,修正配置块缩进
- audit:external 改为防回潮检查:字段存在、help 不得出现披露文案、README 必须保留隐私披露章节
This commit is contained in:
nxxy335 committed 2026-11-11 22:34:32 +08:00
1 parent c92429d139
commit 5c7c6325b1
34 files changed
+500 -210

No files matched your search

+30 -13
View File
@@ -1,32 +1,49 @@
# 自定义页面
自定义页面是 Halo 的独立页面功能,用于创建关于、友链等独立内容页面。
自定义页面是 Halo 的独立页面功能,用于创建关于、留言板、订阅动态、微信读书等独立内容页面。
## 使用方式
1. 进入 Halo 后台 → **页面** → **新建**
2. 填写页面标题和内容
3. 可选择自定义模板
4. 发布页面
3. 可选:在「自定义模板」中选择主题提供的模板
4. 发布页面,并把页面加入导航菜单
页面地址由创建时设定的 slug 决定,主题不为自定义模板提供固定路由。
## 页面模板
主题提供以下自定义页面模板:
`theme.yaml` 中注册了 3 个自定义模板,加上默认的 `page.html` 共 4 种:
| 模板 | 文件 | 说明 |
|------|------|------|
| 默认 | page.html | 标准内容页面 |
| 留言板 | page_messageboard.html | 带评论的留言板页面 |
| 模板 | 模板文件 | 说明 |
|------|---------|------|
| 默认 | `page.html` | 标准内容页面 |
| 留言板(MessageBoard) | `page_messageboard.html` | 带评论的留言墙,标题与副标题可配置 |
| 订阅(Subscriptions) | `page_subscriptions.html` | 博友文章订阅动态,依赖官方「链接管理」插件的 RSS 订阅 |
| 微信读书(WeRead) | `weread.html` | 微信读书书架,依赖微信读书插件,访客免登录查看 |
### 留言板模板
选择留言板模板后,页面会自动集成评论组件,访客可以直接留言。标题和副标题使用主题设置中的配置。
选择留言板模板后,页面会集成评论组件,访客可以直接留言。标题和副标题在
**主题设置 → 留言板** 中配置,详见[留言板配置](/config/messageboard)。
使用步骤:
### 订阅模板
1. 新建页面,选择自定义模板为「留言板」
2. 在主题设置 → 留言板中配置标题和副标题
3. 发布页面,添加到导航菜单
feed / RSS 聚合不再依赖已停止提供的「朋友圈」插件,而由官方
「链接管理」(PluginLinks)插件的订阅能力提供。使用步骤:
1. 安装并启用[链接管理插件](https://www.halo.run/store/apps/app-hfbQg),维护博友链接的 RSS 订阅源
2. 新建页面,自定义模板选择「订阅」
3. 在**主题设置 → 订阅**中调整每页条数、加载方式与布局,详见[订阅配置](/config/subscriptions)
未安装插件或暂无订阅动态时页面会显示友好提示,不会报错。
完整说明见[订阅页面](/pages/subscriptions)。
### 微信读书模板
选择「微信读书」模板后展示书架与阅读记录,标题 / 副标题在
**主题设置 → 微信读书** 中配置,详见[微信读书配置](/config/weread)。
该页面依赖 Halo 2.27+ 的能力。
## 页面功能