search

dirkfabisch / mediator

a medium inspired jekyll theme
blog.base68.com
Other
807 stars 860 forks source link

Add support for an alternative commenting system - Isso #83

Open alexeyza opened 6 years ago

alexeyza commented 6 years ago

It would be awesome to have support for not only Disqus (which works great already) but something like Isso (a simple commenting system, similar to disqus, SQLite backend, self-hosted)

I saw some examples in other themes, e.g., https://github.com/scotte/jekyll-clean/commit/67774ed4aca4cdd2877645a02a7e9eb60cef4f87

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.

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.

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.