友链卡片配置说明

1# hugo-teek-site/config/themes/hugo-teek/homepage.toml
2# 控制友链卡片的显示/隐藏

1# hugo-teek-site/config/themes/hugo-teek/params.toml
2# 友链显示参数配置

1# hugo-teek-site/data/friendLinks.yaml
2# 友链具体数据

1    enabled = true   # ◀️ 显示友链卡片

1    enabled = false  # ◀️ 隐藏友链卡片

1    limit = 5           # ◀️ 每组显示友链数量
2    interval = 5000     # ◀️ 轮播间隔（毫秒）
3    groups = ["Teek道友"]  # ◀️ 指定显示的分组

1    limit = 5           # ◀️ 每组最多显示多少个友链
2    interval = 5000     # ◀️ 自动轮播间隔，5000ms = 5秒
3    groups = []         # ◀️ 显示哪些分组，空数组表示全部

1    groups = []         # ◀️ 空数组表示显示所有分组

1    groups = ["Teek道友"]           # ◀️ 只显示指定分组
2    groups = ["Teek道友", "VitePress"]  # ◀️ 显示多个分组

1    smallTitle = "与各位博主一起成长进步"
2    bannerButtonGroup = true

1    smallTitle = "副标题文字"      # ◀️ 友链页面副标题
2    bannerButtonGroup = true       # ◀️ 是否显示分组按钮

1groups:
2  - title: "Teek道友"           # ◀️ 分组名称
3    links:
4      - name: "站点名称"         # ◀️ 站点名称
5        url: "https://example.com"  # ◀️ 站点链接
6        avatar: "头像URL"        # ◀️ 站点头像
7        description: "站点描述"   # ◀️ 站点描述

 1groups:
 2  - title: "Teek道友"
 3    links:
 4      - name: "余温小站"
 5        url: "https://wiki.xxdevops.cn"
 6        avatar: "https://img.xxdevops.cn/blog/avatar/yuwen_avatar.avif"
 7        description: "明心静性，爱自己"
 8      
 9      - name: "白木の小屋"
10        url: "https://gl.baimu.live"
11        avatar: "https://gl.baimu.live/img/avatar.png"
12        description: "白木的博客"
13  
14  - title: "技术博客"
15    links:
16      - name: "示例博客"
17        url: "https://example.com"
18        avatar: "https://example.com/avatar.png"
19        description: "技术分享"

1# homepage.toml
2[params.homeSidebar.friendLinks]
3    enabled = true

1# params.toml
2[friendLink]
3    limit = 5
4    interval = 5000
5    groups = ["Teek道友"]
6
7[friendPage]
8    smallTitle = "与各位博主一起成长进步"
9    bannerButtonGroup = true

1# data/friendLinks.yaml
2groups:
3  - title: "Teek道友"
4    links:
5      - name: "示例站点"
6        url: "https://example.com"
7        avatar: "https://example.com/avatar.png"
8        description: "示例描述"

 1# ========================================
 2# 首页配置 (Homepage Configuration)
 3# ========================================
 4[params.homeSidebar]
 5
 6  # ========================================
 7  # 友链卡片 (Friend Links Card)
 8  # ========================================
 9  # 显示友情链接
10  # 数据来源：data/friendLinks.yaml
11  [params.homeSidebar.friendLinks]
12    enabled = true  # ◀️ 开关：启用/禁用友链卡片

 1# ========================================
 2# 友链配置 (Friend Links)
 3# ========================================
 4[friendLink]
 5    limit = 5
 6    interval = 5000
 7    groups = ["Teek道友"]
 8
 9[friendPage]
10    smallTitle = "与各位博主一起成长进步"
11    bannerButtonGroup = true

 1原因1：开关未启用
 2解决：检查 homepage.toml 中 enabled = true
 3
 4原因2：数据文件错误
 5解决：
 61️⃣ 检查 data/friendLinks.yaml 是否存在
 72️⃣ 检查 YAML 语法是否正确
 83️⃣ 确保 groups 和 links 结构正确
 9
10原因3：分组配置错误
11解决：
121️⃣ 检查 params.toml 中 groups 配置
132️⃣ 确保分组名称与数据文件中的一致
143️⃣ 或使用空数组显示所有分组

1原因：头像链接失效或跨域
2解决：
31️⃣ 检查 avatar URL 是否可访问
42️⃣ 使用 HTTPS 协议
53️⃣ 使用 CDN 托管头像图片

1# homepage.toml
2[params.homeSidebar.friendLinks]
3    enabled = true
4
5# params.toml
6[friendLink]
7    limit = 5
8    interval = 5000

1# data/friendLinks.yaml
2groups:
3  - title: "分组名称"
4    links:
5      - name: "站点名称"
6        url: "https://example.com"
7        avatar: "头像URL"
8        description: "站点描述"