mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
766085c2dc
81847981f Add notes for installing "extended" Sass/SCSS version 02da3bb58 Include usage of disqus internal template 9b53380c4 Update sitemap-template.md f3417dd52 Update sitemap-template.md aae33d9a8 Update sitemap-template.md 834edc205 Release 0.45.1 fb93ab905 Merge branch 'temp451' 79f350906 releaser: Prepare repository for 0.46-DEV 25cd2352c releaser: Add release notes to /docs for release of 0.45.1 e60377c71 releaser: Bump versions for release of 0.45.1 873f6dce2 Update features.md ecc116642 Update link for Azure cb88c3185 Added .Site.Home to Site Variiables (#541) 975a88791 Document includePaths 56c4e332f Release Hugo 0.45 c22b25210 Merge branch 'temp45' 0ffad3ada releaser: Prepare repository for 0.46-DEV 08d494cc3 releaser: Add release notes to /docs for release of 0.45 ad546ba45 releaser: Bump versions for release of 0.45 971c46bb2 Fixed "Sratch" to become "Scratch" on line 44 a28255bf3 Clarify the meaning of .Pages vs .Site.Pages 127aeee09 docs: Update ref, relref, GetPage docs 350d674ec resources.Concat doesn't have an alias 1fd1219b0 docs: Document refLinksErrorLevel and refLinksNotFoundURL af2252ff6 Merge commit 'a3535c8486b2ce762b1a8a9c30b03985c3e02cee' a11486805 Merge commit 'b6b37a1f00f808f3c0d2715f65ca2d3091f36495' 1c8896cb1 Fix addkit link to account for i18n 468aef3fc releaser: Prepare repository for 0.45-DEV c6f4b97a2 releaser: Add release notes to /docs for release of 0.44 d3985afb7 releaser: Bump versions for release of 0.44 2c59a330c Adjust release notes 83966769a releaser: Prepare repository for 0.44-DEV e539613f7 releaser: Add release notes to /docs for release of 0.43 2bf648944 releaser: Bump versions for release of 0.43 d9d6e4bf7 Fix typos d6798afda Merge commit '98293eaa1570b5aff4452021c8b6d6c8560b3f06' 37cc52261 Add a newScratch template func 1f7f09613 Merge branch 'release-0.42.2' 857b0b26a releaser: Prepare repository for 0.43-DEV git-subtree-dir: docs git-subtree-split: 81847981f1f2cb1ebc83d42d275a2afb2bb22df1
85 lines
3.3 KiB
Markdown
85 lines
3.3 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
|
||
|
||
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" . }}
|
||
```
|
||
|
||
## 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
|