This Blog's Comment System

This website is currently hosted on GitHub Pages via Jekyll (i.e. a “static” website). The source code is available for all to see and each page has a corresponding file on the server. There is no code running on the server to generate content on a per-view basis. This is great for speed and ease of hosting, but bad for dynamic content like comments. Luckily for me, I’m not the first person to run into this issue so I was able to leverage the work of others. Comment’s are submitted to Staticman, which converts the comment into a pull request, which allows me to moderate comments which end up as just another file in the source code of my website. I referred to various blogs to help set this up, but mostly used Made Mistakes Blog and Minimal Mistakes Theme as a template, so thanks Michael Rose!

I especially want to thank Eduardo Bouças, the creator of Staticman. He solved a common problem in an elegant way, released it as open source, then to top it off he hosts the service for free!

Comments pending moderation can be found via GitHub Issues. If you want to modify your comment, you could fork the repo, change your comment, and submit a pull request. I don’t really expect anybody to want to do that, but I find it intriguing that you can!

4 Comments

Daniel Smith

These are some of the more common markdown formatting options you may want to use in your comments:

type:

`Inline code` with backticks

to get:

Inline code with backticks

type:

```
\\ code block version 1
"preceed/follow with 3 backticks"
```

    \\ code block version 2
    "indent all code with 4 spaces"

to get:

\\ code block version 1
"preceed/follow with 3 backticks"

\\ code block version 2
"indent all code with 4 spaces"

type:

*Italic* or _Italic_

to get:

Italic

type:

**Bold** or __Bold__

to get:

Bold

type:

[Link](http://dansmith65.com)

to get:

Link

type:

![Link](http://lorempixel.com/150/100/)

to get:

Link

type:

> Blockquote

to get:

Blockquote

type:

* unordered
* list
  * with
  * sub-list

to get:

unordered
list
- with
- sub-list

type:

ordered
list
with
sub-list
the exact number used
doesn't matter
as long as it's a number

to get:

ordered
list
1. with
2. sub-list
the exact number used
doesn’t matter
as long as it’s a number

type:

Single line breaks
have no effect.
    
Add a new line for a paragraph.
    
If you want to enforce a line break,\\
you need to use two backslashes.

to get:

Single line breaks have no effect.

Add a new line for a paragraph.

If you want to enforce a line break,
you need to use two backslashes.

Daniel Smith

Are comments working yet?

Daniel Smith

Does the form work with javascript disabled?

LaRetta

Hey Dan, this is a great markdown cheatsheet! Thank you. :-)

Comments are closed. If you have something you'd like to say about this post you can email me.