評論小部件

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

期間，你很可能需要引入協力廠商資源，不過這可以通過自定義資源或鉤子輕鬆解决。