mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
90ad804505
392668f4f Update theme 65d82c845 fix versions in GitHub Pages docs (#1815) 4e078a306 Create hosting-on-azure-static-web-apps.md (#1738) e24e25052 fix requirement typo (#1814) 0790eb173 fix broken link (#1813) f4a1b38c7 📄 Add more clarity on merging of config files (#1493) 2e82efff0 Install on Windows: Correct + augment (#1520) 4bffd076e Update frontends to add CloudCannon's CMS (#1509) 17eea3133 Update index.md to add resource (#1508) 5a5ac1d2f Add documentation for babel sourceMap (#1492) 899b7117c Update menu-templates.md 284dc4266 Include flexible translation in i18n.md f03421274 docs: Escaping Hugo/GO template code 4f0755683 Improve the documentation of imageConfig and the image resource 89aa723cc Clarify leaf bundle explanation and related FAQ 0c6b32bb9 Update starter-kits.md a68151b1b Update starter-kits.md 91b145384 Update starter-kits.md c8104b422 Update hosting-on-21yunbox.md 51ee7603b Update hosting-on-21yunbox.md d88314499 docs(en): add hosting on 21YunBox aab04f269 Update shortcode-templates.md to correct an error. ed48563aa Misc improvements 87dd24e1d Fix merge failure 0bcc6dca8 js.Build: Update docs to not allow boolean inputs for sourceMap e50a28fbc js.Build: Add SourceMap flag into js.Build opts which can turn on sourcemap 9695093a1 Fix Arch Linux installation command 3de773d7a Please remove hugo-elasticsearch plugin. 6510f0a5a release: Add some more ignore expressions to release notes config dc90b7517 typoe > typo (!) 3427c7436 Add hugoreleaser config 5a1f2d0dd Improves formatting of resources, assets sections (#1804) 03ba56fdd Remove Flesland Flis from Showcases 9f61dac7a Update slice.md 533e4e0cd Update theme 85e50325c Simplify writing 9b30e81b9 Typo fix and remove passive form 8974b6c53 dynamic-menu-configuration 1c5467329 netlify: Hugo 0.102.3 610a937b0 Remove Over from Showcase 99f5585bc netlify: Hugo v0.102.2 9f230ac1f netlify: Hugo v0.102.1 a6fc3f864 netlify: Bump to Hugo v0.102.0 3e9bc1a62 Merge branch 'tempv0.102.0' c08d6d898 Update en/templates/404.md with Firebase Hosting (#1796) 322b75f40 Update configuration.md 2fa6f0b94 404 template example: remove slash relURL arg 1195f168a Remove broken link (#1767) e0838e574 Update RenderString.md bee6adf71 Update page-resources.md 24e142f22 Remove duplicate word from cascade description 879fc3983 docs: Update the description of PostCSS config 2ffe539e3 fix: Use `=` instead of `:=` for variable reassignments (#1771) 7496b8f87 update 404 error for digitalocean docs c85caca4a Merge commit 'bdf935d66c1f02dfc942a30e9fc00519bba3aacb' c3888b63a docs: Regen docshelper 8a5942555 Merge commit '475f87f685439de0f907a9ffc29bfd1361eb1c59' 282007217 common: Add hugo.GoVersion 00b4b46da resources/page: Add :slugorfilename attribute git-subtree-dir: docs git-subtree-split: 392668f4f488d184b08b227028b01dbc02abd57a
74 lines
2.9 KiB
Markdown
74 lines
2.9 KiB
Markdown
---
|
|
title: Comments
|
|
linktitle: 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.
|
|
date: 2017-02-01
|
|
publishdate: 2017-02-01
|
|
keywords: [sections,content,organization]
|
|
categories: [project organization, fundamentals]
|
|
menu:
|
|
docs:
|
|
parent: "content-management"
|
|
weight: 140
|
|
weight: 140 #rem
|
|
draft: false
|
|
aliases: [/extras/comments/]
|
|
toc: true
|
|
---
|
|
|
|
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 copy="false" >}}
|
|
disqusShortname = "yourDisqusShortname"
|
|
{{</ 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](https://gohugo.io/templates/internal/#disqus) available, to render it add the following code where you want comments to appear:
|
|
|
|
```
|
|
{{ 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)
|
|
* [Commento](https://commento.io/) (Open Source, available as a service, local install, or docker image)
|
|
* [Graph Comment](https://graphcomment.com/)
|
|
* [Hyvor Talk](https://talk.hyvor.com/) (Available as a service)
|
|
* [IntenseDebate](https://intensedebate.com/)
|
|
* [Isso](https://posativ.org/isso/) (Self-hosted, Python) ([tutorial][issotutorial])
|
|
* [Muut](https://muut.com/)
|
|
* [Remark42](https://remark42.com/) (Open source, Golang, Easy to run docker)
|
|
* [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
|