Let GitHub host the comments for your GitHub Pages
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.editorconfig
.gitignore
LICENSE
README.md
demo_comment.gif

README.md

GitHub Comments for your GitHub Pages

With ghpages-ghcomments, your Jekyll site can use GitHub to provide reader comments.

Set up is straightforward, and everything has been automated to hook into your git workflow (read more).

Leaving a comment

Examples

The blog posts on this site show how ghpages-ghcomments works.

Browse the GitHub storage for their comments.

Advantages

It's good for your readers

  1. Your readers' web habits are not tracked by services like Disqus.
  2. Your readers have full control over their comments -- they can edit and delete them.
  3. Page presentation is still Jekyll-fast from lean built-in JavaScript -- no jQuery or other "frameworks".
  4. Customize the look and feel with a small collection of CSS classes.

It's good for you

  1. You don't need your own dedicated server to host a Discourse instance.
  2. Comment threads are automatically created with every git push to your site.
  3. Set up takes 5 minutes and the rest is triggered -- set and forget.
  4. Aggregate all of your sites' comments together in one place -- a GitHub repository.

Setup

These commits show just how easy it is:

Follow these instructions.

Post index

Change log

  • 20 Jan 2015: First release
  • 02 Feb 2015: Fix issues #6 and #7
  • 08 Feb 2015: Add diagnostics (issue #10)
  • 15 Mar 2015: Add on-page comments (issue #11)
  • 21 May 2015: Fix diagnostics; fix hooks for the Mac (issue #17)
  • 16 Aug 2015: Add comment controls
  • 29 Sep 2015: Add 'bootstrap' command for creating comment threads for already-published posts
  • 24 Nov 2015: Add error handling for initial conditions

Full history: release branch commit log