2.5 KiB
2.5 KiB
友情链接
友情链接模块用于展示与其他站点的互链关系，是博客社交属性的重要体现。WarmIsland 提供了三种展示样式，适配不同的视觉偏好。
配置项一览
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
links_page_title |
文本 | 友情链接 |
页面标题 |
links_style |
下拉 | cards |
展示样式：grid / list / cards |
前置依赖
::: danger 友情链接功能依赖 Halo 的 PluginLinks 插件。如果未安装此插件，友情链接页面将无法正常工作。
安装方式：Halo 后台 → 插件 → 安装 → 搜索「链接管理」→ 安装并启用。 :::
详细说明
页面标题（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 支持链接分组功能。你可以将友链按不同类别分组（如「技术博客」「生活博客」「工具站点」等），页面会以分组为单位展示。