评论小部件

Disqus、Utterances 和 Giscus 评论小部件都是开箱即用的。本文将展示如何配置它们，甚至自定义你自己的评论小部件。

Disqus#

Disqus 评论小部件由 Hugo 提供支持。

1disqusShortname = "yourdiscussshortname"

请注意：disqusShortname 是站点配置，而非参数。将其放在 params 是行不通的。

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`。

Giscus is a lightweight comments widget built on GitHub discussions.

1[giscus]
2  repo = "user/repo"
3  repoId = ""
4  category = ""
5  categoryId = ""

Name	Type	Default	Description
`giscus.repo`	String	-	GitHub repository. Required.
`giscus.repoId`	String	-	GitHub repository ID. Required.
`giscus.category`	String	-	Discussions category. Required.
`giscus.categoryId`	String	-	Discussions category ID. Required.
`giscus.theme`	String	-	Left it empty if you want to follow the theme mode.
`giscus.mapping`	String	`pathname`	The mapping between blog posts and GitHub discussions: `pathname`, `url`, `title` and `og:title`.
`giscus.inputPosition`	String	`top`	The input position: `top` or `bottom`.
`giscus.reactions`	Boolean	`true`	Turn on/off the reactions.
`giscus.metadata`	Boolean	`false`	Emit discussion metadata.
`giscus.lang`	String	-	Specify language, default to site language.
`giscus.lazyLoading`	Boolean	`true`	Enable lazy loading.

我们不打算支持所有的评论小部件，但别担心，你完全可以自定义评论小部件。

在创建自己的评论小部件之前，需要禁用其他评论小部件。

1mkdir -p layouts/partials/post/comments
2echo "MY COMMENTS WIDGET" > layouts/partials/post/comments/custom.html

期间，你很可能需要引入第三方资源，不过这可以通过自定义资源或钩子轻松解决。