# Haprial Hugo Theme

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

## 特性

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

## 安装

```bash
cd your-hugo-site
git clone https://github.com/yourname/haprial themes/haprial
```

## 快速开始

1. 复制示例配置到博客根目录：

```bash
cp themes/haprial/hugo.example.toml hugo.toml
```

2. 编辑 `hugo.toml`，填入你自己的配置（域名、标题、描述等）

3. 将你的个人资源放到博客根目录的 `static/` 下：

```
your-hugo-site/
├── static/
│   └── image/
│       ├── avatar/       # 你的头像
│       ├── posts/        # 文章中的图片/视频/音频
│       └── background/   # 背景图片
├── content/
│   ├── posts/            # 你的文章
│   ├── about.md          # 关于页
│   └── ...
├── data/
│   └── links.json        # 友链数据
└── hugo.toml             # 你的配置
```

4. 启动 Hugo：

```bash
hugo server -D
```

## 配置说明

```toml
[params]
  description = "你的博客描述"
  keywords = "关键词"
  bio = "你的个性签名"
  avatar = "/image/avatar/avatar.jpg"   # 头像路径（放在根目录 static/ 下）
  startYear = "2024"                     # 建站年份
  icp = ""                               # ICP 备案号（可选）
  rss = true                             # 是否启用 RSS
  artalk = false                         # 是否启用 Artalk 评论
  artalkServer = ""                      # Artalk 服务器地址
```

## 菜单配置

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

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

## 主题目录结构

```
themes/haprial/
├── archetypes/          # 文章模板
├── layouts/
│   ├── _default/
│   │   ├── baseof.html  # 基础模板
│   │   ├── list.html    # 首页/列表页
│   │   ├── single.html  # 文章详情页
│   │   ├── about.html   # 关于页
│   │   ├── archives.html # 归档页
│   │   └── links.html   # 友链页
│   └── partials/
│       ├── header.html
│       ├── footer.html
│       ├── floating-tools.html
│       └── search-modal.html
├── static/
│   ├── css/style.css    # 主样式文件
│   ├── js/core.js       # 核心 JavaScript
│   ├── emotion/         # 表情包资源
│   └── font/            # 自定义字体
├── hugo.example.toml    # 示例配置模板
├── theme.toml           # 主题元数据
└── README.md
```

## 说明

本主题是干净的主题，**不包含任何个人内容**。

- 所有个人资源（头像、文章图片/视频/音频、背景图等）应放在博客根目录的 `static/` 目录下
- Hugo 的 static 目录合并机制会自动将根目录和主题的 static 目录合并，URL 路径不变
- 友链数据放在 `data/links.json`
- 文章内容放在 `content/posts/`

## 图标

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

## 许可

MIT License
