update README.md

2026-05-19 17:25:43 +08:00
parent 31997e51c8
commit 5194d14fb0
57 changed files with 39100 additions and 0 deletions
@@ -0,0 +1,75 @@
+# 评论
+
+评论配置控制全站评论区域的外观样式，影响文章详情页、留言板等所有包含评论组件的页面。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) — 全局样式与配色配置