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:
1 parent
c92429d139
commit
5c7c6325b1
34 files changed
+500
-210
No files matched your search
@@ -0,0 +1,53 @@
|
||||
# 订阅页面
|
||||
|
||||
订阅页面按时间倒序展示博友们的最新文章,即原先「朋友圈 / feed 聚合」所提供的能力。
|
||||
现在它由 **Halo 官方「链接管理」(PluginLinks)插件的 RSS 订阅**驱动,主题提供
|
||||
`page_subscriptions.html` 自定义模板负责前端展示。
|
||||
|
||||
## 使用方式
|
||||
|
||||
1. 安装并启用 [链接管理插件](https://www.halo.run/store/apps/app-hfbQg),在插件中维护博友链接的 RSS 订阅源
|
||||
2. 进入 Halo 后台 → **页面** → **新建**
|
||||
3. 选择自定义模板「**订阅**」(`Subscriptions`,对应 `page_subscriptions.html`)
|
||||
4. 发布页面,并按需加入导航菜单
|
||||
|
||||
> 页面地址由你创建页面时设定的 slug 决定,主题**不提供固定的 `/subscriptions` 路由**;
|
||||
> 只有插件提供的扩展页面(如 `/links`、`/moments`)才是固定路由。
|
||||
|
||||
## 页面内容
|
||||
|
||||
每条订阅动态是一张卡片,包含:
|
||||
|
||||
- 作者头像(缺失时显示首字占位)、作者名称与主页链接
|
||||
- 发布日期
|
||||
- 文章标题(点击跳转原文)、摘要
|
||||
- 空数据时的友好提示,以及未安装链接管理插件时的安装引导
|
||||
|
||||
标题与作者链接均使用 `target="_blank"` + `rel="noopener noreferrer"`,
|
||||
主题本身不会向第三方发起请求。
|
||||
|
||||
## 展示与加载
|
||||
|
||||
在[订阅配置](/config/subscriptions)中可调:
|
||||
|
||||
| 能力 | 可选值 |
|
||||
| --- | --- |
|
||||
| 布局 | 单列列表卡片 / 网格卡片(窄屏自动收敛列数) |
|
||||
| 加载方式 | 底部分页(较新 / 较旧)/ 下滑自动加载 |
|
||||
| 每页条数 | 1–100,默认 20 |
|
||||
| 标题与副标题 | 自定义文本 |
|
||||
|
||||
## 从「朋友圈」迁移
|
||||
|
||||
`plugin-friends`(朋友圈)插件已不再提供,原来的 `/friends` 页面与「朋友圈」设置分组
|
||||
仅作为旧站点兼容保留,模板检测到插件不可用时会显示空状态。迁移步骤:
|
||||
|
||||
1. 安装 / 启用「链接管理」插件,把原本在朋友圈插件里维护的 RSS 订阅源迁到链接管理插件的订阅中
|
||||
2. 新建一个页面并选择「订阅」自定义模板
|
||||
3. 确认动态正常展示后,删除旧的 `/friends` 页面与菜单项
|
||||
|
||||
## 相关配置
|
||||
|
||||
- [订阅配置](/config/subscriptions) — 全部 5 个设置项
|
||||
- [友情链接页面](/pages/links) — 同一插件的友链展示
|
||||
- [扩展页面](/pages/extended) — 插件前台页面一览
|
||||
Reference in new issue
Block a user