精选文章卡片配置说明

1# hugo-teek-site/config/themes/hugo-teek/homepage.toml
2# 控制精选文章卡片的显示/隐藏

1# 文章 Front Matter 中设置
2# 位于每篇文章的头部

1    enabled = true   # ◀️ 显示精选文章卡片

1    enabled = false  # ◀️ 隐藏精选文章卡片

1---
2title: "文章标题"
3date: "2026-03-02T10:00:00+08:00"
4featured: true    # ◀️ 标记为精选文章
5---
6
7文章内容...

1---
2title: "普通文章"
3date: "2026-03-02T10:00:00+08:00"
4featured: false   # ◀️ 不标记为精选（默认）
5---
6
7文章内容...

 1# 文章1：精选
 2---
 3title: "Hugo-Teek 主题安装教程"
 4featured: true
 5---
 6
 7# 文章2：精选
 8---
 9title: "Markdown 语法大全"
10featured: true
11---
12
13# 文章3：普通
14---
15title: "日常随笔"
16featured: false
17---

1┌─────────────────────────────┐
2│ ⭐ 精选文章                   │
3├─────────────────────────────┤
4│ 📄 文章标题1                  │
5│ 📄 文章标题2                  │
6│ 📄 文章标题3                  │
7│ 📄 文章标题4                  │
8│ 📄 文章标题5                  │
9└─────────────────────────────┘

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

1# content/posts/my-post.md
2---
3title: "Hugo-Teek 主题安装教程"
4date: "2026-03-02T10:00:00+08:00"
5featured: true
6---

 1# ========================================
 2# 首页配置 (Homepage Configuration)
 3# ========================================
 4[params.homeSidebar]
 5
 6  # ========================================
 7  # 精选文章卡片 (Featured Posts Card)
 8  # ========================================
 9  # 显示标记为精选的文章
10  # 数据来源：文章 Front Matter 中设置 featured: true
11  [params.homeSidebar.featuredPosts]
12    enabled = true  # ◀️ 开关：启用/禁用精选文章卡片

 1原因1：开关未启用
 2解决：检查 homepage.toml 中 enabled = true
 3
 4原因2：无精选文章
 5解决：
 61️⃣ 检查文章 Front Matter 中是否设置 featured: true
 72️⃣ 确保文章已发布（draft: false）
 83️⃣ 执行 make dev 重新构建
 9
10原因3：文章未发布
11解决：
121️⃣ 检查文章 draft 字段
132️⃣ 确保 draft: false 或删除该字段

1原因：日期格式错误或时区问题
2解决：
31️⃣ 使用标准 ISO 8601 格式：YYYY-MM-DDTHH:MM:SS+08:00
42️⃣ 确保所有精选文章都有正确的 date 字段
53️⃣ 重新构建站点

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

1---
2title: "文章标题"
3date: "2026-03-02T10:00:00+08:00"
4featured: true   # ◀️ 标记为精选文章
5---

1# ========================================
2# 精选文章卡片 (Featured Posts Card)
3# ========================================
4# 显示标记为精选的文章
5# 数据来源：文章 Front Matter 中设置 featured: true
6[params.homeSidebar.featuredPosts]
7    enabled = true  # ◀️ 开关：启用/禁用精选文章卡片