nxxy335
5c7c6325b1
- 文档对齐 1.2.7：feed/RSS 聚合改由官方链接管理插件订阅承担、Halo 要求统一 >=2.27.0、补齐设置分组文档、清理与代码不符的描述，并修复正文引用块留白 - 三个可选 API 设置项 help 只保留功能说明，隐私披露统一由 README「外部资源与隐私」与文档站承载；字段恢复按开关条件显示，修正配置块缩进 - audit:external 改为防回潮检查：字段存在、help 不得出现披露文案、README 必须保留隐私披露章节
79 lines
3.1 KiB
Markdown
79 lines
3.1 KiB
Markdown
# 友情链接
|
||
|
||
友情链接模块用于展示与其他站点的互链关系，是博客社交属性的重要体现。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 聚合功能已由它取代），
|
||
对应主题的[订阅配置](/config/subscriptions)与[订阅页面](/pages/subscriptions)。
|
||
:::
|
||
|
||
## 详细说明
|
||
|
||
### 页面标题（links_page_title）
|
||
|
||
友情链接页面的标题，显示在页面顶部。
|
||
|
||
```yaml
|
||
links_page_title: "友情链接" # 默认
|
||
links_page_title: "友链" # 简称
|
||
links_page_title: "Friends" # 英文站点
|
||
```
|
||
|
||
### 展示样式（links_style）
|
||
|
||
| 值 | 说明 |
|
||
| --- | --- |
|
||
| `grid` | 网格样式，友链以均匀的网格卡片排列，紧凑整齐 |
|
||
| `list` | 列表样式，友链以水平列表项排列，信息展示更完整 |
|
||
| `cards` | 卡片样式，友链以独立卡片展示，视觉层次丰富（默认） |
|
||
|
||
::: tip
|
||
`cards` 样式最为推荐，它在视觉效果和信息展示之间取得了最佳平衡。`grid` 样式适合友链数量较多的站点，`list` 样式适合需要展示详细描述信息的场景。
|
||
:::
|
||
|
||
## 链接管理
|
||
|
||
友情链接的数据通过 Halo 后台管理，而非主题设置面板。管理步骤如下：
|
||
|
||
1. 登录 Halo 后台管理控制台
|
||
2. 进入 **链接** → **新建** 添加友情链接
|
||
3. 填写链接信息：
|
||
- **名称** — 站点名称
|
||
- **URL** — 站点地址
|
||
- **Logo** — 站点 Logo 或头像
|
||
- **描述** — 站点简介
|
||
- **分组** — 链接分组（可选）
|
||
4. 保存后，友情链接页面会自动展示
|
||
|
||
::: tip
|
||
建议为每个友链填写 Logo 和描述信息，这样在 `cards` 和 `grid` 样式下展示效果更佳。Logo 推荐使用正方形图片。
|
||
:::
|
||
|
||
### 分组管理
|
||
|
||
PluginLinks 支持链接分组功能。你可以将友链按不同类别分组（如「技术博客」「生活博客」「工具站点」等），页面会以分组为单位展示。
|
||
|
||
## 相关页面
|
||
|
||
- [订阅配置](/config/subscriptions) — 同一插件提供的 RSS 订阅动态
|
||
- [订阅页面](/pages/subscriptions) — 博友文章动态页面
|
||
- [页脚](/config/footer) — 页脚社交链接配置
|
||
- [友情链接页面](/pages/links) — 友链模板与结构说明
|