mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-30 01:13:35 -05:00
75 lines
3 KiB
Markdown
75 lines
3 KiB
Markdown
|
---
|
||
|
|
title: Comments
|
||
|
|
description: Hugo ships with an internal Disqus template, but this isn't the only commenting system that will work with your new Hugo website.
|
||
|
|
categories: [content management]
|
||
|
|
keywords: [sections,content,organization]
|
||
|
|
menu:
|
||
|
|
docs:
|
||
|
|
parent: content-management
|
||
|
|
weight: 220
|
||
|
|
weight: 220
|
||
|
|
toc: true
|
||
|
|
aliases: [/extras/comments/]
|
||
|
|
---
|
||
|
|
|
||
|
|
Hugo ships with support for [Disqus](https://disqus.com/), a third-party service that provides comment and community capabilities to websites via JavaScript.
|
||
|
|
|
||
|
|
Your theme may already support Disqus, but if not, it is easy to add to your templates via [Hugo's built-in Disqus partial][disquspartial].
|
||
|
|
|
||
|
|
## Add Disqus
|
||
|
|
|
||
|
|
Hugo comes with all the code you need to load Disqus into your templates. Before adding Disqus to your site, you'll need to [set up an account][disqussetup].
|
||
|
|
|
||
|
|
### Configure Disqus
|
||
|
|
|
||
|
|
Disqus comments require you set a single value in your [site's configuration file][configuration] like so:
|
||
|
|
|
||
|
|
{{< code-toggle file=hugo >}}
|
||
|
|
[services.disqus]
|
||
|
|
shortname = 'your-disqus-shortname'
|
||
|
|
{{</ code-toggle >}}
|
||
|
|
|
||
|
|
For many websites, this is enough configuration. However, you also have the option to set the following in the [front matter] of a single content file:
|
||
|
|
|
||
|
|
* `disqus_identifier`
|
||
|
|
* `disqus_title`
|
||
|
|
* `disqus_url`
|
||
|
|
|
||
|
|
### Render Hugo's built-in Disqus partial template
|
||
|
|
|
||
|
|
Disqus has its own [internal template](/templates/internal/#disqus) available, to render it add the following code where you want comments to appear:
|
||
|
|
|
||
|
|
```go-html-template
|
||
|
|
{{ template "_internal/disqus.html" . }}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Alternatives
|
||
|
|
|
||
|
|
These are some alternatives to Disqus:
|
||
|
|
|
||
|
|
* [Cactus Comments](https://cactus.chat/docs/integrations/hugo/) (Open Source, Matrix appservice, Docker install)
|
||
|
|
* [Comentario](https://gitlab.com/comentario/comentario) (Open Source, self-hosted, Go/Angular, run locally, in Docker or Kubernetes)
|
||
|
|
* [Commento](https://commento.io/) (Open Source, available as a service, local install, or docker image)
|
||
|
|
* [Giscus](https://giscus.app/) (Open source, comments system powered by GitHub Discussions)
|
||
|
|
* [Graph Comment](https://graphcomment.com/)
|
||
|
|
* [Hyvor Talk](https://talk.hyvor.com/) (Available as a service)
|
||
|
|
* [IntenseDebate](https://intensedebate.com/)
|
||
|
|
* [Isso](https://isso-comments.de/) (Self-hosted, Python) ([tutorial][issotutorial])
|
||
|
|
* [Muut](https://muut.com/)
|
||
|
|
* [Remark42](https://remark42.com/) (Open source, Golang, Easy to run docker)
|
||
|
|
* [ReplyBox](https://getreplybox.com/)
|
||
|
|
* [Staticman](https://staticman.net/)
|
||
|
|
* [Talkyard](https://blog-comments.talkyard.io/) (Open source, & serverless hosting)
|
||
|
|
* [Utterances](https://utteranc.es/) (Open source, GitHub comments widget built on GitHub issues)
|
||
|
|
|
||
|
|
[configuration]: /getting-started/configuration/
|
||
|
|
[disquspartial]: /templates/internal/#disqus
|
||
|
|
[disqussetup]: https://disqus.com/profile/signup/
|
||
|
|
[forum]: https://discourse.gohugo.io
|
||
|
|
[front matter]: /content-management/front-matter/
|
||
|
|
[kaijuissue]: https://github.com/spf13/kaiju/issues/new
|
||
|
|
[issotutorial]: https://stiobhart.net/2017-02-24-isso-comments/
|
||
|
|
[partials]: /templates/partials/
|
||
|
|
[MongoDB]: https://www.mongodb.com/
|
||
|
|
[tweet]: https://twitter.com/spf13
|