76 lines
2.5 KiB
Markdown
76 lines
2.5 KiB
Markdown
# 评论
|
||
|
||
评论配置控制全站评论区域的外观样式，影响文章详情页、留言板等所有包含评论组件的页面。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) — 全局样式与配色配置
|