热门标签卡片配置说明

1# hugo-teek-site/config/themes/hugo-teek/homepage.toml
2# 控制热门标签卡片的显示/隐藏

1    enabled = true   # ◀️ 显示热门标签卡片

1    enabled = false  # ◀️ 隐藏热门标签卡片

1---
2title: "文章标题"
3tags:
4    - Hugo
5---

1---
2title: "文章标题"
3tags:
4    - Hugo
5    - 博客
6    - 教程
7    - 静态网站
8---

1特大标签：使用 20+ 次
2大标签：   使用 10-19 次
3中标签：   使用 5-9 次
4小标签：   使用 1-4 次

1┌─────────────────────────────┐
2│ 🏷️ 热门标签                   │
3├─────────────────────────────┤
4│                             │
5│   Hugo    博客    教程       │
6│      前端      运维          │
7│   笔记   工具    配置        │
8│                             │
9└─────────────────────────────┘

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

 1# content/posts/my-post.md
 2---
 3title: "Hugo-Teek 主题安装教程"
 4date: "2026-03-02T10:00:00+08:00"
 5tags:
 6    - Hugo
 7    - 博客
 8    - 教程
 9    - 主题
10---

 1# ========================================
 2# 首页配置 (Homepage Configuration)
 3# ========================================
 4[params.homeSidebar]
 5
 6  # ========================================
 7  # 热门标签卡片 (Hot Tags Card)
 8  # ========================================
 9  # 显示热门标签云
10  [params.homeSidebar.hotTags]
11    enabled = true  # ◀️ 开关：启用/禁用热门标签卡片

 1原因1：开关未启用
 2解决：检查 homepage.toml 中 enabled = true
 3
 4原因2：无标签数据
 5解决：
 61️⃣ 检查文章是否设置了 tags
 72️⃣ 确保文章已发布（draft: false）
 83️⃣ 执行 make dev 重新构建
 9
10原因3：标签数量过少
11解决：
121️⃣ 为更多文章添加标签
132️⃣ 确保标签使用频率达到显示阈值

1原因：CSS 冲突或加载失败
2解决：
31️⃣ 检查浏览器控制台是否有 CSS 错误
42️⃣ 清除浏览器缓存
53️⃣ 检查主题文件是否完整

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

1---
2title: "文章标题"
3tags:
4    - 标签1
5    - 标签2
6    - 标签3
7---

1# ========================================
2# 热门标签卡片 (Hot Tags Card)
3# ========================================
4# 显示热门标签云
5[params.homeSidebar.hotTags]
6    enabled = true  # ◀️ 开关：启用/禁用热门标签卡片