mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
d2b1030060
0fd7b4169 Fix typo: pygmentsUseClasses -> pygmentsUseClassic 9a3e1c19a Clarify that lower weight gets higher precedence 820d8b581 Clarify the true behavior of hrefTargetBlank #blackfriday eb3aa5e46 Fix typo 9aedb9269 Add examples for removing default taxonomies 772a26f84 Fix source link on maintainance 975c215ae Minor edits. 2bdb1a150 Fix invalid iink 991d2e139 Fix misspelling 60af8dfb0 Update eSolia link d7426b76e Release 0.40.3 4977bd9cf Merge branch 'release-0.40.3' 9946f7108 releaser: Prepare repository for 0.41-DEV beef16b01 releaser: Add release notes to /docs for release of 0.40.3 80c51c55a releaser: Bump versions for release of 0.40.3 21e2934c5 rename `taxonomies.html` to `taxonomy.html` 34a02c289 Add release notes from Hugo 0.7 to 0.15 for completeness b593f512e Update related.md 7c2bf528b Fix the "edit this page" link e8fbc163e Add warning about cond ae15a8831 Add link to Markdown Guide e077dfd65 Added documentation for a new migration tool: BlogMl2Hugo 957bfb6a8 Add Talkayrd, a new commenting system, & fix txtpen link 86acea7f8 Tomango showcase 3c2fc32f1 Fix snap classic command in installing.md 9a76f1737 Merge commit '83bef6955e014d40c0f00db9cebe09113154e999' a4b71fb84 Fix typo git-subtree-dir: docs git-subtree-split: 0fd7b416997bf76cd99e3ae2dfae406cb8b6724a
81 lines
3.2 KiB
Markdown
81 lines
3.2 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
|
||
lastmod: 2017-03-09
|
||
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 = "yourdiscussshortname"
|
||
{{</ 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
|
||
|
||
See [Partial Templates][partials] to learn how to add the Disqus partial to your Hugo website's templates.
|
||
|
||
## Comments Alternatives
|
||
|
||
There are a few alternatives to commenting on static sites for those who do not want to use Disqus:
|
||
|
||
* [Static Man](https://staticman.net/)
|
||
* [Talkyard](https://www.talkyard.io/blog-comments) (Open source, & serverless hosting)
|
||
* [txtpen](https://txtpen.github.io/hn/)
|
||
* [IntenseDebate](http://intensedebate.com/)
|
||
* [Graph Comment][]
|
||
* [Muut](http://muut.com/)
|
||
* [isso](http://posativ.org/isso/) (Self-hosted, Python)
|
||
* [Tutorial on Implementing Isso with Hugo][issotutorial]
|
||
|
||
|
||
<!-- I don't think this is worth including in the documentation since it seems that Steve is no longer supporting or developing this project. rdwatters - 2017-02-29.-->
|
||
<!-- * [Kaiju](https://github.com/spf13/kaiju) -->
|
||
|
||
<!-- ## Kaiju
|
||
|
||
[Kaiju](https://github.com/spf13/kaiju) is an open-source project started by [spf13](http://spf13.com/) (Hugo’s author) to bring easy and fast real time discussions to the web.
|
||
|
||
Written using Go, Socket.io, and [MongoDB][], Kaiju is very fast and easy to deploy.
|
||
|
||
It is in early development but shows promise. If you have interest, please help by contributing via pull request, [opening an issue in the Kaiju GitHub repository][kaijuissue], or [Tweeting about it][tweet]. Every bit helps. -->
|
||
|
||
[configuration]: /getting-started/configuration/
|
||
[disquspartial]: /templates/partials/#disqus
|
||
[disqussetup]: https://disqus.com/profile/signup/
|
||
[forum]: https://discourse.gohugo.io
|
||
[front matter]: /content-management/front-matter/
|
||
[Graph Comment]: https://graphcomment.com/
|
||
[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
|