This is the start of my tech blog so I thought why not describe the steps it took to create it? The tasks were trivial maybe but not obvious.

Here goes:

  • install Ruby
  • install Bundler
  • install Jekyll

Go to the directory where you want to put your site directory

$ jekyll new your-site-name
$ cd your-site-name
$ git init
$ git commit -m "initial"

Create a Gemfile

Add

source 'https://rubygems.org'
gem 'github-pages'

Run

$bundle install

To see that the install went correctly run

$bundle exec jekyll serve

Go to your browser and navigate to http://127.0.0.1:4000/.

You will see a generic Jekyll page. you can start personalizing the site by editing the _config.yml. The official instructions are pretty good

To add new posts, simply add a file in the _posts directory that follows the convention YYYY-MM-DD-name-of-post.ext and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Jekyll also offers powerful support for code snippets:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.