日历卡片配置说明

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

1    enabled = true   # ◀️ 显示日历卡片

1    enabled = false  # ◀️ 隐藏日历卡片

1🟩 深绿色：发布 4+ 篇文章
2🟨 中绿色：发布 3 篇文章
3🟧 浅绿色：发布 2 篇文章
4🟦 淡绿色：发布 1 篇文章
5⬜ 灰色：无发布记录

1- 显示最近 365 天的发布记录
2- 按周排列，每周一列
3- 月份标签在顶部显示
4- 悬停显示具体日期和文章数

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

 1# ========================================
 2# 首页配置 (Homepage Configuration)
 3# ========================================
 4[params.homeSidebar]
 5
 6  # ========================================
 7  # 日历卡片 (Calendar Card)
 8  # ========================================
 9  # 显示文章发布日历热力图
10  [params.homeSidebar.calendar]
11    enabled = true  # ◀️ 开关：启用/禁用日历卡片

 1原因1：开关未启用
 2解决：检查 homepage.toml 中 enabled = true
 3
 4原因2：无文章数据
 5解决：
 61️⃣ 确保站点有已发布的文章
 72️⃣ 检查文章 Front Matter 中 date 字段是否正确
 83️⃣ 文章 date 格式应为："2026-03-02T10:00:00+08:00"
 9
10原因3：构建缓存问题
11解决：执行 make clean 后重新构建

1原因：文章日期格式错误或时区问题
2解决：
31️⃣ 统一使用 ISO 8601 格式：YYYY-MM-DDTHH:MM:SS+08:00
42️⃣ 检查时区设置是否正确
53️⃣ 确保文章已发布（draft: false）

1date: "2026-03-02T10:30:00+08:00"
2date: "2026-03-02T10:30:00Z"
3date: "2026-03-02"

1date: "2026/03/02"        # ◀️ 使用了斜杠
2date: "03-02-2026"        # ◀️ 格式顺序错误
3date: 2026-03-02          # ◀️ 缺少引号

1    enabled = true

1# ========================================
2# 日历卡片 (Calendar Card)
3# ========================================
4# 显示文章发布日历热力图
5[params.homeSidebar.calendar]
6    enabled = true  # ◀️ 开关：启用/禁用日历卡片