# 评论

评论配置控制全站评论区域的外观样式，影响文章详情页、留言板等所有包含评论组件的页面。WarmIsland 基于 Halo 的 `halo:comment` 组件提供评论功能，并提供了样式定制选项。

## 配置项一览

| 配置项 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `comment_style` | 下拉 | `warm` | 评论样式：`warm` / `minimal` |
| `comment_show_avatar` | 开关 | `true` | 显示头像 |

## 详细说明

### 评论样式（comment_style）

| 值 | 说明 |
| --- | --- |
| `warm` | 暖色风格，与暖屿主题整体风格一致，圆角卡片、柔和配色（默认） |
| `minimal` | 极简风格，去除装饰性元素，线条简洁，适合内容导向型站点 |

::: tip
`warm` 样式与暖屿的整体设计语言最为协调，推荐大多数用户使用。`minimal` 样式适合希望让评论区域更低调、不抢夺正文注意力的场景。
:::

### 显示头像（comment_show_avatar）

开启后，每条评论左侧会显示评论者的头像。关闭后，评论以纯文本形式排列，节省空间。

::: tip
如果站点评论以匿名或短评为主，可以考虑关闭头像以获得更紧凑的布局。如果评论互动较多，建议保持开启以增强社交感。
:::

## 评论功能说明

WarmIsland 的评论系统基于 Halo 的 `halo:comment` 组件实现，提供以下核心功能：

### 回复

支持多级嵌套回复，访客可以针对特定评论进行回复，形成讨论线程。

### 点赞

每条评论支持点赞功能，访客可以表达对评论的认同。

### Markdown 支持

评论内容支持 Markdown 基础语法，包括：

- **粗体** 和 *斜体*
- 代码（行内 `` `code` `` 和代码块）
- 链接
- 列表

::: warning
为安全起见，评论中的 Markdown 支持是受限的，不支持 HTML 标签注入、JavaScript 执行等危险操作。
:::

### 评论管理

评论数据通过 Halo 后台统一管理：

1. 登录 Halo 后台管理控制台
2. 进入 **评论** 管理页面
3. 可以查看、审核、回复和删除评论
4. 支持设置评论审核规则（如需审核后发布）

::: tip
建议开启评论审核功能以防止垃圾评论。可以在 Halo 后台 → **设置** → **评论** 中配置评论审核策略。
:::

## 相关页面

- [留言板](/config/messageboard) — 留言板页面配置
- [文章](/config/article) — 文章详情页配置
- [样式设置](/config/style) — 全局样式与配色配置
