So we've recently remade this site from the ground up to be more blogger-friendly. Our goal was to push out content(blogs) quickly and efficiently. The old method of creating blogs was a bit slow and messy. We didn't want to put everything into a single html file like how we had before. Now here's where Jekyll comes in.
What is Jekyll?
Jekyll is a blogging engine popularized by Github. They've made it integrate pretty nicely with their Github-pages platform. Probably the biggest advantage of using Jekyll is that it allows you to write blogposts in markdown. If you don't know what markdown is, it's essentially a different way of writing text files. It makes a lot more sense creating documents this way as it allows you to include links, images and more while typing naturally.
Jekyll also provides structure to project. If you're new to web development, conforming to an organized standard is helpful in developing good practice.
First Steps: How to Install Jekyll
Since this tutorial series will be covering a lot of information, I want to keep them short by just doing baby-steps. For this first tutorial, we will just install Jekyll and launch our first site.
First, go to the rubyinstaller website and download the most recent one.
Run the installer. Then when you get to
Installation Detection and Optional Tasks
Make sure to check "Add Ruby executables to your path" so it looks like this:
Continue with the installation and it should finish pretty quickly. You now have Ruby and can access it in your
Next, you need to get ruby devkit It's the same page as before - just scroll down a bit. Choose
64 bit depending on what kind o system you run and download it.
Create a folder somewhere on your computer and call it something like
Turn on your
command prompt and change the directory to where ever you created your
As a noob, what I do is type
cd in the
command prompt and then drag the folder right into the
command prompt. This gets the exact directory of where the folder is.
Then, go back to the rubydevkit you just installed and then extract it into the
Go to your
command prompt and type:
ruby dk.rb init
ruby dk.rb install
And that's it! You're set up for Windows! For reference to installing Ruby on Windows, check out this site.
Now to install jekyll, all you need to do is type this command in your
gem install jekyll
If you're on Mac and it's complaining about permissions, type
sudo gem install jekyll instead.
And there you have it! You now have Jekyll! So now, let's make something with it.
Creating a New Project
Change your directory to anywhere you want. Or not, if the default is fine. Then type:
jekyll new myblog
Next, go to your web browser and type
http://localhost:4000 to see your new site.
Doesn't it look good?
This concludes the first part of the Jekyll series. Tune in later for more tutorials that will explore the various parts of Jekyll. Hope this helps!
This article was written by Steven Yang. Follow him on Twitter