站点统计卡片配置说明

最后更新于:

📊 站点统计卡片概述

站点统计卡片展示站点的基本统计信息,包括文章数、分类数、标签数等,让访客快速了解站点规模,也展示了博主的创作成果。

✨ 卡片特性

🎨 设计特性

  • 数字展示:醒目的统计数字
  • 图标装饰:每个统计项配有图标
  • 布局整齐:网格或列表布局
  • 实时更新:数据自动统计

⚙️ 功能特性

  • 自动统计:自动计算站点数据
  • 无需维护:数据实时更新
  • 独立开关:可随时启用/禁用
  • 多项统计:文章、分类、标签等

📁 配置文件路径

站点统计卡片配置位于首页配置文件中:

1# hugo-teek-site/config/themes/hugo-teek/homepage.toml
2# 控制站点统计卡片的显示/隐藏

📝 开关配置

启用/禁用站点统计卡片

1    enabled = true   # ◀️ 显示站点统计卡片
1    enabled = false  # ◀️ 隐藏站点统计卡片

📈 统计项说明

自动统计内容

站点统计卡片自动统计以下信息:

1📄 文章总数:站点所有已发布文章数量
2📂 分类数量:站点所有分类数量
3🏷️ 标签数量:站点所有标签数量
4📅 运行天数:站点自创建以来的运行天数
 1┌─────────────────────────────┐
 2│ 📊 站点统计                   │
 3├─────────────────────────────┤
 4│                             │
 5│   📄 文章      128 篇        │
 6│   📂 分类       12 个        │
 7│   🏷️ 标签       56 个        │
 8│   📅 运行      365 天        │
 9│                             │
10└─────────────────────────────┘

统计数据来源

🤖 数据来源

站点统计卡片数据完全自动统计:

1️⃣ 文章数:统计 content/ 目录下所有 draft: false 的文章
2️⃣ 分类数:统计所有文章中 categories 的唯一值数量
3️⃣ 标签数:统计所有文章中 tags 的唯一值数量
4️⃣ 运行天数:从第一篇发布的文章日期计算至今


📋 完整配置示例

基础配置

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

配置位置示例

 1# ========================================
 2# 首页配置 (Homepage Configuration)
 3# ========================================
 4[params.homeSidebar]
 5
 6  # ========================================
 7  # 站点统计卡片 (Site Info Card)
 8  # ========================================
 9  # 显示站点统计信息(文章数、分类数等)
10  [params.homeSidebar.siteInfo]
11    enabled = true  # ◀️ 开关:启用/禁用站点统计卡片

🔧 常见问题

统计数据不准确

 1原因1:包含草稿文章
 2解决:
 31️⃣ 检查文章 draft 字段
 42️⃣ 确保草稿文章设置为 draft: true
 53️⃣ 重新构建站点
 6
 7原因2:缓存问题
 8解决:
 91️⃣ 执行 make clean 清理缓存
102️⃣ 重新执行 make dev
11
12原因3:统计范围错误
13解决:
141️⃣ 检查 content/ 目录结构
152️⃣ 确保文章在正确的目录下

运行天数计算错误

1原因:最早文章日期设置错误
2解决:
31️⃣ 检查最早发布的文章日期
42️⃣ 确保第一篇发布的文章 date 字段正确
53️⃣ 运行天数从最早文章日期开始计算

📝 配置模板速查

最小化配置

1    enabled = true
1# ========================================
2# 站点统计卡片 (Site Info Card)
3# ========================================
4# 显示站点统计信息(文章数、分类数等)
5[params.homeSidebar.siteInfo]
6    enabled = true  # ◀️ 开关:启用/禁用站点统计卡片

🎉 站点统计卡片配置完成!

站点统计卡片无需额外配置内容,启用后即可自动显示站点统计数据。

推荐使用微信支付
微信支付二维码
推荐使用支付宝
支付宝二维码
最新文章