# Haprial Hugo Theme

一个简洁优雅的 Hugo 博客主题，支持毛玻璃效果、暗色/亮色切换、弹幕效果等特性。

## 特性

- 🌓 **亮色/暗色主题** - 点击头像切换昼夜模式
- 🔍 **文章搜索** - 内联搜索 + 弹窗搜索双模式
- 🎯 **弹幕效果** - 首页弹幕滚动展示
- 📱 **响应式设计** - 完美适配手机端
- ✨ **毛玻璃效果** - 现代感的 glassmorphism 设计
- 🎨 **代码高亮** - macOS 风格三色圆点窗口
- ⚡ **动画效果** - 滑入动画、骨架屏加载
- 💬 **评论系统** - 支持 Artalk 评论
- 📝 **自定义字体** - 使用 zql 手写风格字体
- 🔗 **友链页面** - 带头像的友链展示
- 📅 **归档页面** - 按年份分组的文章归档

## 快速开始

```bash
# 1. 克隆主题
cd your-hugo-site
git clone https://github.com/yourname/haprial-theme themes/haprial

# 2. 复制配置模板
cp themes/haprial/hugo.example.toml hugo.toml

# 3. 编辑配置
# 修改 hugo.toml 中的 baseURL、title、avatar 等参数

# 4. 添加头像
mkdir -p static/image/avatar
cp your-avatar.jpg static/image/avatar/avatar.jpg

# 5. 启动
hugo server -D
```

## 目录结构

```
your-hugo-site/
├── hugo.toml              # 站点配置（从 hugo.example.toml 复制）
├── content/
│   ├── about.md           # 关于页
│   ├── archives.md        # 归档页
│   ├── circles.md         # 友圈页
│   ├── comment.md         # 留言页
│   └── posts/             # 文章目录
├── data/
│   └── links.json         # 友链数据
├── static/
│   ├── image/
│   │   ├── avatar/        # 头像
│   │   ├── posts/         # 文章图片/视频/音频
│   │   └── background/    # 背景图
│   └── ...
└── themes/
    └── haprial/           # 主题（纯净，不含个人内容）
```

## 配置说明

编辑 `hugo.toml`：

| 参数 | 说明 |
|------|------|
| `baseURL` | 站点地址 |
| `title` | 站点标题 |
| `params.bio` | 个性签名 |
| `params.avatar` | 头像路径 |
| `params.startYear` | 建站年份 |
| `params.icp` | ICP备案号（留空不显示） |
| `params.artalk` | 是否启用Artalk评论 |
| `params.artalkServer` | Artalk服务器地址 |
| `params.cdn` | CDN赞助信息（支持HTML） |

## 菜单配置

```toml
[[menus.main]]
  name = "首页"
  url = "/"
[[menus.main]]
  name = "关于"
  url = "/about/"

[[menus.social]]
  name = "GitHub"
  url = "https://github.com/yourname"
  identifier = "ri-github-fill"
```

## 文章格式

```markdown
---
title: "文章标题"
date: 2024-01-01
draft: false
tags: ["标签"]
categories: ["分类"]
summary: "摘要"
---

正文内容...
```

文章中引用图片放在 `static/image/posts/` 目录下。

## 图标

主题使用 [RemixIcon](https://remixicon.com/) 图标库。

## 许可

MIT License
