Files
halo-theme-WarmIsland/docs/config/comment.md
T

2.2 KiB
Raw Blame History

评论

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

配置项一览

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

详细说明

评论样式(comment_style

使用原版评论样式。

::: 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 后台 → 设置评论 中配置评论审核策略。 :::

相关页面