Background

A couple of months ago, Don Williamson demonstrated a clever technique for displaying Github issue comments on a static blog post. He also provided a nice write up of the technique.

Limitations

A limitation of the implementaion was that it was specific to the Hugo static site generator. It turns out though that with minor changes, it can be adapted to work with a site based on the Jekyll static site generator.

Jekyll

This blog is based on Jekyll and includes the changes needed to support use of Github comments. This post has Github comments enabled so that the comments shown below are from a Github issue. To add to those comments, click the “Post a comment on Github” button below. This will take you to a Github page at which anyone logged in to Github can add a comment to the discussion that shows up at the bottom of this page.

Modifications

The code consists of four new files and two modifications:

New Files _includes/github-comments.html _sass/_gh-code.scss _sass/_gh-comments.scss js/github-comments.js

Modified Files _layouts/default.html _sass/minima.scss



Reference Implementation

The repository dc25/minimaWithGithubComments is a clone of the jekyll/minima repository modified to allow Github comments. In addition to the above Github comments changes, the blog contains a single post that shares the same comments as this post.

Configuration