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).

Examples

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

• Comments with markdown
• Several comments
• One comment
• No comments

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:

• Add new files
• Configure
• Link to CSS
• Include in posts

Follow these instructions.

Post index

• 02 Feb 2015: Issue 6 is fixed
• 07 Feb 2015: Use Diagnostics to Troubleshoot
• 08 Feb 2015: Use the Browser Console to Troubleshoot
• 16 Aug 2015: Introducing Comment Control
• 03 Oct 2015: Using ghpages-ghcomments with Private GitHub Repositories

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