1 Fork 0

Files

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.3 KiB

Raw Blame History

订阅页面

订阅页面按时间倒序展示博友们的最新文章，即原先「朋友圈 / feed 聚合」所提供的能力。现在它由 Halo 官方「链接管理」（PluginLinks）插件的 RSS 订阅驱动，主题提供 page_subscriptions.html 自定义模板负责前端展示。

使用方式

安装并启用链接管理插件，在插件中维护博友链接的 RSS 订阅源
进入 Halo 后台 → 页面 → 新建
选择自定义模板「订阅」（Subscriptions，对应 page_subscriptions.html）
发布页面，并按需加入导航菜单

页面地址由你创建页面时设定的 slug 决定，主题不提供固定的 /subscriptions 路由；只有插件提供的扩展页面（如 /links、/moments）才是固定路由。

页面内容

每条订阅动态是一张卡片，包含：

作者头像（缺失时显示首字占位）、作者名称与主页链接
发布日期
文章标题（点击跳转原文）、摘要
空数据时的友好提示，以及未安装链接管理插件时的安装引导

标题与作者链接均使用 target="_blank" + rel="noopener noreferrer"，主题本身不会向第三方发起请求。

展示与加载

在订阅配置中可调：

能力	可选值
布局	单列列表卡片 / 网格卡片（窄屏自动收敛列数）
加载方式	底部分页（较新 / 较旧）/ 下滑自动加载
每页条数	1–100，默认 20
标题与副标题	自定义文本

从「朋友圈」迁移

plugin-friends（朋友圈）插件已不再提供，原来的 /friends 页面与「朋友圈」设置分组仅作为旧站点兼容保留，模板检测到插件不可用时会显示空状态。迁移步骤：

安装 / 启用「链接管理」插件，把原本在朋友圈插件里维护的 RSS 订阅源迁到链接管理插件的订阅中
新建一个页面并选择「订阅」自定义模板
确认动态正常展示后，删除旧的 /friends 页面与菜单项

2.3 KiB Raw Blame History Unescape Escape