Disqus 和 Utterances 评论小部件都是开箱即用的。本文将展示如何配置它们,甚至自定义你自己的评论小部件。
Disqus#
Disqus 评论小部件由 Hugo 提供支持。
1disqusShortname = "yourdiscussshortname"
请注意:
disqusShortname
是站点配置,而非参数。将其放在params
是行不通的。
Utterances#
Utterances 是一个基于 GitHub issue 的轻量级的评论挂件。
1[utterances]
2 repo = "user/repo"
3 #issueTerm = "pathname" # pathname, url, title, og:title.
4 #label = "comment" # Optional.
5 #theme = ""
不同于 Disqus,Utterances 是一个参数。请将其放置在
params
。
参数#
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
utterances.repo | String | - | GitHub 仓库。 |
utterances.issueTerm | String | pathname | 文章和 issue 之间的映射: pathname |
utterances.label | String | - | 此标签将会分配给 Utterances 创建的 issue。 |
utterances.theme | String | - | 如果未设置任何主题,亮色和暗色模式会分别使用 github-light 和 github-dark 。 可选值: github-light , github-dark , preferred-color-scheme , github-dark-orange , icy-dark , dark-blue 和 photon-dark 。 |
故障排查#
- 确保仓库是公开的,否则读者无法查看评论。
- 确保仓库已经安装了 utterances app,否则用户无法发表评论。
- 如果你的仓库是克隆的,请在设置中确保已经启用了 issues 功能。
自定义评论小部件#
我们不打算支持所有的评论小部件,但别担心,你完全可以自定义评论小部件。
在创建自己的评论小部件之前,需要禁用其他评论小部件。
1mkdir -p layouts/partials/post/comments
2echo "MY COMMENTS WIDGET" > layouts/partials/post/comments/custom.html
评论