公告卡片配置说明

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

1# hugo-teek-site/data/announcement.yaml
2# 编辑公告的具体内容

1    enabled = true   # ◀️ 显示公告卡片

1    enabled = false  # ◀️ 隐藏公告卡片

1title: "📢 站点公告"
2content: |
3  欢迎来到我的博客！
4  这里记录着我的技术成长历程。
5icon: "bell"

1title: "公告标题"     # ◀️ 卡片标题，支持 emoji
2content: |           # ◀️ 公告内容，支持 Markdown
3  多行内容使用 | 符号
4  支持 **加粗**、*斜体* 等格式
5icon: "图标名称"      # ◀️ Bootstrap Icons 图标名

 1announcements:
 2  - title: "🎉 新功能上线"
 3    content: |
 4      评论系统已接入，欢迎交流讨论！
 5    icon: "chat-dots"
 6    date: "2026-03-01"
 7    
 8  - title: "📢 维护通知"
 9    content: |
10      本站将于本周日凌晨进行例行维护。
11    icon: "tools"
12    date: "2026-02-28"
13    
14  - title: "📝 更新日志"
15    content: |
16      新增暗色模式、优化移动端体验。
17    icon: "journal-text"
18    date: "2026-02-25"

 1title: "📢 重要通知"
 2content: |
 3  ## 🎉 站点升级完成
 4  
 5  本次更新内容包括：
 6  - **新主题**：更换为 Hugo-Teek 主题
 7  - **新功能**：新增搜索、评论功能
 8  - **优化**：提升页面加载速度
 9  
10  [查看详情](/about/website/)
11icon: "stars"

1title: "🔗 友情链接"
2content: |
3  欢迎访问我的其他站点：
4  
5  - [GitHub](https://github.com/xxx)
6  - [技术文档](/docs/)
7  - **邮箱联系**：xxx@example.com
8icon: "link-45deg"

 1# 通知类
 2icon: "bell"           # ◀️ 铃铛 - 普通通知
 3icon: "info-circle"    # ◀️ 信息 - 重要信息
 4icon: "exclamation-triangle"  # ◀️ 警告 - 警告通知
 5
 6# 功能类
 7icon: "stars"          # ◀️ 星星 - 新功能
 8icon: "gift"           # ◀️ 礼物 - 活动/福利
 9icon: "heart"          # ◀️ 爱心 - 感谢/致谢
10
11# 其他
12icon: "calendar"       # ◀️ 日历 - 日程通知
13icon: "clock"          # ◀️ 时钟 - 时间相关
14icon: "megaphone"      # ◀️ 喇叭 - 重要公告

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

 1# data/announcement.yaml
 2title: "📢 欢迎来到我的博客"
 3content: |
 4  这里是 **Hugo-Teek** 主题演示站点。
 5  
 6  本博客专注于：
 7  - 🖥️ 运维技术分享
 8  - 🎨 前端开发经验
 9  - 💻 编程学习笔记
10  
11  欢迎交流讨论！
12icon: "emoji-smile"

 1# data/announcement.yaml
 2announcements:
 3  - title: "🎉 新功能上线"
 4    content: |
 5      搜索功能已全面启用！
 6      支持全文检索，快速找到所需内容。
 7    icon: "search"
 8    date: "2026-03-01"
 9    
10  - title: "📢 维护通知"
11    content: |
12      本周日凌晨 2:00-4:00 进行服务器维护，
13      期间可能出现短暂访问中断。
14    icon: "tools"
15    date: "2026-02-28"
16    
17  - title: "📝 更新日志"
18    content: |
19      **v1.2.0 更新内容：**
20      1. 新增暗色模式
21      2. 优化移动端体验
22      3. 修复已知问题
23    icon: "journal-text"
24    date: "2026-02-25"

 1原因1：开关未启用
 2解决：检查 homepage.toml 中 enabled = true
 3
 4原因2：YAML 语法错误
 5解决：
 61️⃣ 使用 YAML 验证器检查语法
 72️⃣ 注意缩进使用空格而非 Tab
 83️⃣ 特殊字符需要转义
 9
10原因3：文件路径错误
11解决：确认文件位于 hugo-teek-site/data/announcement.yaml

 1原因：YAML 格式问题
 2解决：
 31️⃣ 使用 | 符号表示多行文本
 42️⃣ 确保正确缩进
 53️⃣ 避免混用空格和 Tab
 6
 7示例：
 8content: |
 9  ## 标题
10  - 列表项1
11  - 列表项2

1# data/announcement.yaml
2title: "公告"
3content: "公告内容"
4icon: "bell"

 1# data/announcement.yaml
 2# 单条公告
 3title: "📢 公告标题"
 4content: |
 5  支持 **Markdown** 格式的公告内容。
 6  
 7  - 列表项1
 8  - 列表项2
 9  
10  [链接文本](URL)
11icon: "info-circle"
12
13# 或者多条公告轮播
14announcements:
15  - title: "公告1"
16    content: "内容1"
17    icon: "bell"
18    date: "2026-03-01"
19  - title: "公告2"
20    content: "内容2"
21    icon: "info"
22    date: "2026-03-02"