October 11, 2013
This blog was just created using Jekll and GitHub pages. The number one goal was having control of the files I publish. Word Press, Tumbler, Medium, SharePoint, or anything platform based was out. I just want to push static pages (html/css/js) without anything sever side. But I wanted a bit more ease than having to type each line of HTML myself. No need to insert
<p> tags if something can take care of simple styles for me. Which is exactly what Jekyll can do. Jekyll is a Ruby script that takes in text files and spits out all of the complete html needed to upload directly to your favorite host. However I was not looking to pay for hosting. Luckily GitHub Pages are free and are coincidently built on Jekyll as well. So how do you use Jekyll? And how do you post your Jekyll generated site for free to GitHub?
Use this guide!
After looking through a few Jekyll/GitHub Pages guides, I finally stumbled on this magnificant tutorial. It explains Jekyll with a goal of hosting your site on Amazon, but everything up until the Amazon piece can be followed exactly. The high level overview:
Very simple. Create a new repository in GitHub called yourusername.github.com.
Add the files and folders you created by following Andrew Munsell’s wonderful tutorial. Wait a couple of minutes. Go to that URL. The source files are automatically ran through Jekyll by GitHub and your site will magically appear.
Just a few steps - follow this guide directly from GitHub:
You will add a CNAME file to the root of your GitHub repository. Then go to your domain provider and add an A Record to your DNS settings that points your custom domain name to the GitHub server IP.
Head over to their web site and register for an account.
Choose Universal Code for your platform.
Disqus will provide the necessary code. Just copy and paste the code into your _layouts/post.html page, which will add the Disqus comment section to each post.