分类页面使用说明

1[taxonomies]
2  category = "categories"
3  tag = "tags"

 1---
 2title: 分类
 3url: /categories/
 4layout: categories
 5description: 浏览所有文档分类，快速找到你感兴趣的内容
 6
 7categoriesConfig:
 8  # 📌 页面标题区域
 9  header:
10    icon: "📂"                    # 标题图标
11    title: "文档分类"             # 自定义标题
12    subtitle: "探索知识的海洋"    # 自定义副标题
13
14  # 💳 概览卡片配置
15  overview:
16    enabled: true                 # 是否显示概览区域
17    cards:
18      - type: "gradient"          # 渐变卡片（显示热门分类）
19        label: "热门分类"
20        showCount: true           # 是否显示文档数
21      - type: "text"              # 文字卡片（显示文档总数）
22        label: "文档总数"
23        desc: "篇文档等待探索"
24
25  # 🏷️ 分类导航配置（从文档 frontmatter categories: 动态读取）
26  tags:
27    enabled: true                 # 是否显示分类导航
28    title: "分类导航"             # 区域标题
29    icon: "🏷️"                    # 标题图标
30    showCount: true               # 是否显示各分类的文档数量
31
32  # 📝 文档列表配置（marquee 无限滚动样式）
33  articles:
34    enabled: true                 # 是否显示文档列表
35    title: "文档列表"             # 区域标题
36    icon: "📝"                    # 标题图标
37    showSubtitle: true            # 是否显示文档数量副标题
38    columns: 6                    # marquee 显示的文档数量
39
40  # 📊 统计图表配置
41  stats:
42    enabled: true                 # 是否显示统计区域
43    title: "分类统计"             # 区域标题
44    icon: "📊"                    # 标题图标
45    showBar: true                 # 是否显示进度条
46
47  # 💬 评论配置
48  comments:
49    enabled: false                # 是否显示评论区
50---

 1# 简洁模式：隐藏概览卡片、统计区和评论区，仅保留标题、分类导航和文档列表
 2categoriesConfig:
 3  header:
 4    icon: "📂"          # 标题区域图标
 5    title: "文档分类"   # 页面主标题
 6  overview:
 7    enabled: false      # 关闭概览卡片区域（热门分类/文档总数/分类数量/最近更新）
 8  tags:
 9    enabled: true       # 开启分类导航标签云
10    showCount: true     # 标签旁显示该分类下的文档数量
11  articles:
12    enabled: true       # 开启文档列表（marquee 无限滚动）
13    columns: 4          # 文档列表一次性展示 4 篇
14  stats:
15    enabled: false      # 关闭分类统计图表
16  comments:
17    enabled: false      # 关闭评论区

 1# 完整模式：展示所有区块，适合作为分类主页使用
 2categoriesConfig:
 3  header:
 4    icon: "📚"                      # 标题区域图标
 5    title: "知识库"                 # 页面主标题
 6    subtitle: "分类整理，高效检索"  # 标题下方的副标题描述
 7  overview:
 8    enabled: true                   # 开启概览卡片区域（显示热门分类/文档总数等）
 9  tags:
10    enabled: true                   # 开启分类导航标签云
11    title: "快速导航"               # 自定义标签云区域的标题
12    icon: "🏷️"                     # 标签云区域标题前的图标
13  articles:
14    enabled: true                   # 开启文档列表（marquee 无限滚动）
15    columns: 8                      # 文档列表一次性展示 8 篇
16    showSubtitle: true              # 在区域标题旁显示 "共 N 篇" 数量副标题
17  stats:
18    enabled: true                   # 开启分类统计图表
19    showBar: true                   # 统计项显示可视化进度条
20  comments:
21    enabled: true                   # 开启评论区

 1# 仅统计模式：隐藏文档列表和概览卡片，专注展示分类分布统计
 2categoriesConfig:
 3  header:
 4    icon: "📊"          # 标题区域图标（仅保留标题头部）
 5  overview:
 6    enabled: false      # 关闭概览卡片区域
 7  tags:
 8    enabled: true       # 开启分类导航标签云，方便切换分类
 9    showCount: true     # 标签旁显示该分类下的文档数量
10  articles:
11    enabled: false      # 关闭文档列表
12  stats:
13    enabled: true       # 开启分类统计图表（核心展示内容）
14    showBar: true       # 统计项显示可视化进度条，直观对比分类热度
15  comments:
16    enabled: false      # 关闭评论区

1// 获取所有分类及数量（从文档 frontmatter categories: 读取）
2.Site.Taxonomies.categories.ByCount
3
4// 获取当前分类下的文档
5.Pages.ByPublishDate.Reverse
6
7// 读取配置
8.Params.categoriesConfig

 1---
 2# 文档 Frontmatter 示例：只需添加 categories 字段即可自动归入对应分类
 3title: "文档标题"      # 文档标题，会显示在分类页面的文档列表中
 4date: 2026-06-17      # 发布日期，用于排序和显示
 5categories:           # 文档所属分类（Hugo taxonomy 系统自动识别）
 6  - "博客"            # 分类名称，对应分类页面导航标签中的显示名
 7tags:                 # 文档标签（与分类页面无直接关联，供其他功能使用）
 8  - "Hugo"
 9  - "CSS"
10---