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

3.1 KiB

Raw Blame History

友情链接

友情链接模块用于展示与其他站点的互链关系，是博客社交属性的重要体现。WarmIsland 提供了三种展示样式，适配不同的视觉偏好。

配置项一览

配置项	类型	默认值	说明
`links_apply_form_enabled`	开关	`true`	页底显示友链申请表单；需插件开启「友链申请」，否则自动隐藏
`links_page_title`	文本	`友情链接`	页面标题
`links_style`	下拉	`cards`	展示样式：`grid` / `list` / `cards`
`links_show_comment`	开关	`false`	页面底部显示评论区
`links_random_order`	开关	`false`	友链卡片随机排列
`links_random_portal`	开关	`true`	页面右上角显示「随机传送」按钮

前置依赖

::: danger 友情链接功能依赖 Halo 的 PluginLinks 插件。如果未安装此插件，友情链接页面将无法正常工作。

安装方式：Halo 后台 → 插件 → 安装 → 搜索「链接管理」→ 安装并启用。

同一个插件还提供 RSS 订阅能力（原「朋友圈」插件的 feed 聚合功能已由它取代），对应主题的订阅配置与订阅页面。 :::

详细说明

页面标题（links_page_title）

友情链接页面的标题，显示在页面顶部。

links_page_title: "友情链接"    # 默认
links_page_title: "友链"        # 简称
links_page_title: "Friends"     # 英文站点

展示样式（links_style）

值	说明
`grid`	网格样式，友链以均匀的网格卡片排列，紧凑整齐
`list`	列表样式，友链以水平列表项排列，信息展示更完整
`cards`	卡片样式，友链以独立卡片展示，视觉层次丰富（默认）

::: tip cards 样式最为推荐，它在视觉效果和信息展示之间取得了最佳平衡。grid 样式适合友链数量较多的站点，list 样式适合需要展示详细描述信息的场景。 :::

链接管理

友情链接的数据通过 Halo 后台管理，而非主题设置面板。管理步骤如下：

登录 Halo 后台管理控制台
进入链接 → 新建添加友情链接
填写链接信息：
- 名称 — 站点名称
- URL — 站点地址
- Logo — 站点 Logo 或头像
- 描述 — 站点简介
- 分组 — 链接分组（可选）
保存后，友情链接页面会自动展示

::: tip 建议为每个友链填写 Logo 和描述信息，这样在 cards 和 grid 样式下展示效果更佳。Logo 推荐使用正方形图片。 :::

分组管理

PluginLinks 支持链接分组功能。你可以将友链按不同类别分组（如「技术博客」「生活博客」「工具站点」等），页面会以分组为单位展示。

3.1 KiB Raw Blame History Unescape Escape