# 首页

首页是网站的入口，由 Hero 首屏、置顶文章和文章列表三个模块组成。

## 页面结构

首页从上到下依次为：

1. **Hero 首屏** — 全屏展示区（可通过 Hero 设置关闭）
2. **置顶文章** — 显示置顶的文章，大卡片布局
3. **文章列表** — 非置顶文章的流式布局

## Hero 首屏

Hero 区域占据整个视口高度，包含：

- **主标题**：默认使用站点标题，可在主题设置中自定义
- **副标题**：默认使用站点副标题
- **描述文案**：支持一言 API、自定义文案或关闭
- **视觉效果**：渐变背景 + 呼吸光球 + 滚动模糊

页面滚动时，Hero 区域会产生模糊效果，内容向上淡出，底部有向下箭头提示滚动。

Hero 设置详见 [Hero 首屏配置](/config/hero)。

## 置顶文章

在 Halo 后台将文章设置为「置顶」后，该文章会出现在首页置顶区域：

- 单篇置顶：全宽大卡片展示
- 多篇置顶：两列网格布局
- 显示分类、日期、标题和摘要
- 支持封面图，悬停时图片微缩放

## 文章列表

非置顶文章以流式卡片布局展示：

- **有封面图**：左侧内容 + 右侧缩略图
- **无封面图**：纯文字布局
- **移动端**：统一为上下布局

每张卡片显示以下信息（均可通过主题设置控制显隐）：

- 分类标签
- 发布日期
- 文章标题
- 文章摘要（可配置行数）
- 标签列表
- 阅读量

## 文章加载方式

支持两种加载方式，在 [首页配置](/config/home) 中设置：

### 分页

传统翻页导航，页面底部显示「较新」「较旧」按钮和页码信息。

### 无限滚动

滚动到页面底部时自动加载下一页文章，新文章以渐入动画出现。加载过程中显示旋转加载指示器，全部加载完毕后显示提示文案。

## 相关配置

- [首页配置](/config/home) — 置顶/文章模块、卡片显示项、加载方式
- [Hero 首屏配置](/config/hero) — 标题、描述、视觉效果
- [样式设置](/config/style) — 配色、圆角、动画