This is how I created this blog with Jekyll and put it on GitHub Pages.

You can browse the repo at


After installing Jekyll you can create a new blog with the command:

jekyll new <path>

Take a look at the Quick-start Instructions on for more information.

If you don’t like the command line, consider using Jekyll Now.

Update these files with your own content:

  • _config.yml

My configuration ended up like this:

I added Google Analytics and changed the permalinks to my liking.

The jekyll-sitemap and jekyll-gist gems are also nice features to add.

Consider adding these files:

  • favicon.png
  • robots.txt

GitHub Pages supports custom 404 pages.

A robots.txt file may contain a link to the sitemap, generated by the jekyll-sitemap gem.

GitHub Pages

Create a repo on GitHub and push your Jekyll files to a gh-pages branch, if you are using a project site. Refer to the documentation on Jekyll GitHub Pages for more information.

Get yourself a domain and add a CNAME file to the root of the repo.

My CNAME file for this blog looks like this:

Then refer to the documentation about using a custom domain with GitHub Pages.

In my case I followed the instructions for configuring A records with your DNS provider.

Then it should only be a matter of time until your domain begins to resolve to your Jekyll site on GitHub Pages.


Smashing Magazine had a great article about Static Website Generators.

Want comments on your website? Add Disqus, Isso or Facebook comments. Want social integration? Add Twitter or Facebook’s JavaScript widget to your website.

I have decided not to include comments on the site, yet. Should I?