nishanths / cocoa-hugo-theme

Responsive Hugo blog theme (note: not actively worked on)
https://cocoa-hugo-theme-demo.netlify.app/
MIT License
326 stars 155 forks source link

Support for Isso (a Disqus alternative) #20

Open tristan-k opened 7 years ago

tristan-k commented 7 years ago

As alternative for Disqus I would like to see support for Isso, which can be selfhosted. For further reading see the quickstart documentation.

Now, you embed Isso to your website:

<script data-isso="//comments.example.tld/"
        src="//comments.example.tld/js/embed.min.js"></script>

<section id="isso-thread"></section>
nishanths commented 6 years ago

@tristan-k update: in case it helps we have piwik support now

nishanths commented 6 years ago

we also have gitalk support now

VincentTam commented 5 years ago

Hi, this is the maintainer of @staticmanlab, a public GitLab instance of Staicman. It might be very late, but here's some shortcomings of the commenting systems mentioned above.

  1. Isso contains a 3rd-party script to be loaded during page rendering. The above code block shows that the static comments are not rendered as static HTML code. This hinders search engines from grabbing the comments, which are part of the site's content.
  2. gitalk supports only GitHub, and it requires user login before commenting. This can scare away many non programmers from leaving a comment to your posts. Besides, comments are part of the site's static content, not a software package problem. As a result, using GtiHub issues for comment storage is wrong in principle and bad in terms of SEO.

You may avoid these problems by switching to Staticman, which makes use of GitHub/GitLab Pull/Merge Requests instead of issues. Under Staticman's model, static comments are YML/JSON files stored in the remote GitHub/GitLab repo (usually under data/comments, configurable through the path parameter in root-level staticman.yml), and through a static blog generator (Jekyll/Hugo/etc), the stored data are rendered as part of the content. This gives a total ownership of a static site's comments.