📚 简介

✨ 核心功能与亮点

• 瀑布流布局： 随性自由的内容展示。

• 智能筛选： 支持标签和颜色筛选。

• 模式切换： 提供深色模式，支持多链接和画廊模式。

• 贴心功能： 网站统计、访客问候、庆祝撒花等。

• 简易配置： 大部分功能通过 YAML 文件轻松配置。

• 纯静态： 易于部署，无需后端。

🚀 快速上手 (基于 Cloudflare Pages)

1. 准备： 注册 Github 和 Cloudflare 账号。（可选）准备自己的域名。

2. 复制仓库： Fork Bluf Github 仓库 到你的 Github 仓库。

3. 基础配置： 编辑仓库根目录下的 hugo.toml 文件，修改网站网址、名称、SEO 等基础信息。

4. Cloudflare 部署： 在 Cloudflare Pages 连接 Github 仓库，选择 Hugo 预设框架并部署。部署成功后可绑定自定义域名。

ℹ️ 常见问题： 访问异常多为域名问题，部署失败请检查日志和配置文件格式。

🛠️ 使用指南

📂 文件结构概览

• hugo.toml: 网站基础配置、主题参数。

• data/cards.yaml: 导航卡片内容。

• data/tag_classes.yaml: 标签映射关系。

• data/navbar.yaml: 导航栏配置 (外链、筛选、标签)。

• assets/img/: 导航卡片头图。

• assets/gallery/: 画廊模式图片。

• static/: 网站图标、验证文件等。

📝 导航卡片配置 (data/cards.yaml)

🔗 多链接示例：

🖼️ 头图与画廊： 将图片放入 assets/img/ (头图) 或 assets/gallery/ (画廊) 目录下，文件名与卡片标题一致。在 hugo.toml 中开启 gallery = true 支持画廊模式。

🏷️ 标签与导航栏 (data/tag_classes.yaml, data/navbar.yaml)

• data/tag_classes.yaml: 定义标签与筛选值的映射。

• data/navbar.yaml: 配置导航栏的外链、筛选类别和热门标签。

✨ 其他特色配置 (hugo.toml)

• 访客问候 (greetings, mobileGreetings)： 配置随机问候语。

• 庆祝撒花 (confettiEmojis)： 配置清除筛选时的撒花表情。

• 个性化 (lightColor, darkColor)： 修改强调色。

• SEO 与统计： 配置 SEO 信息，支持 Umami 或 Cloudflare Web Analytics 统计。

💡 小贴士： 在 Markdown 文章中插入 {{< random >}} 或 {{< total >}} 短码可实现随机跳转或统计卡片数量。