The following notes were made while building this blog; source code is available here.

GitHub

If you don’t already have one, sign up for a GitHub account here. Go to your Github Dashboard and create a new repository named jfisher-usgs.github.com (here and elsewhere replace jfisher-usgs with your GitHub username). Don’t run any of their suggested setup commands.

Jekyll-Bootstrap

Open a GitBash window, a command prompt with access to Git, and install Jekyll-Bootstrap:

$ git clone https://github.com/plusjade/jekyll-bootstrap.git jfisher-usgs.github.com
$ cd jfisher-usgs.github.com
$ git remote set-url origin git@github.com:jfisher-usgs/jfisher-usgs.github.com.git
$ git push origin master

After GitHub has a couple minutes to refresh your blog, it is publicly available at http://jfisher-usgs.github.com.

Ruby

Install Ruby, available here, on your local machine; the file I downloaded was rubyinstaller-1.9.3-p194.exe.

Twitter-2.0

Install Twitter-2.0 theme packaged for Jekyll-Bootstrap to get a responsive design.

$ rake theme:install git="https://github.com/gdagley/theme-twitter-2.0"

After the install is successful, the task will ask you if you’d like to switch to the newly installed theme. Type y and enter to switch.

Pygments

For code highlighting using pygments, the following steps are necessary: Install Python, available here; the file I downloaded was python-2.7.3.msi. Add C:/Python27 to your PATH, a system environment variable.

In order to install Pygments through the easy_install command, open a GitBash window and install Distribute:

$ curl -O http://python-distribute.org/distribute_setup.py
$ python distribute_setup.py

Add C:/Python27/Scripts to your PATH and install Pygments from the Windows Command Prompt:

$ easy_install Pygments

Download pygments_style.css from here and replace all occurrences of .syntax with .highlight. Save file as /assets/themes/twitter-2.0/css/syntax.css. Add the following line to the default.html file:

<link href="/assets/themes/twitter-2.0/css/syntax.css" rel="stylesheet" type="text/css">

A patch is needed if you get the following error running Pygmentize:

Liquid error: Bad file descriptor

Open a GitBash window and install the patch:

$ cd C:/Ruby193/lib/ruby/gems/1.9.1/gems/albino-1.3.3/lib
$ wget https://raw.github.com/gist/1185645/0001-albino-windows-refactor.patch
$ patch -p1 < 0001-albino-windows-refactor.patch

Ruby Development Kit

Install the Ruby Development Kit on your local machine if you want to be able to preview your content before publishing. The development kit is available here; the file I downloaded was DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe. Extract files into C:/RubyDevKit.

Open a GitBash window and install the Jekyll ruby gem:

$ cd C:/RubyDevKit
$ ruby dk.rb init
$ ruby dk.rb install
$ gem install jekyll

Open a GitBash window and start a Jekyll Server:

$ cd D:/Software/jfisher-usgs.github.com
$ jekyll --server

This will start a local server that will serve up your blog while you are working locally. See it in your browser at http://localhost:4000. As long as you leave this GitBash window open you’ll have the server running at that port to test your code locally.

Providers

I chose Disqus as a comments provider; register your site here and make note of the short_name. Google was chosen for an analytics provider; make note of your tracking_id.

Configure

Open a text editor and configure the _config.yml file. The following changes were made:

title : jfisher-usgs
tagline: blog
author :
  name : Jason C Fisher
  email : XXXXXXX@XXXX.XXX
  github : jfisher-usgs

# Production URL
production_url : http://jfisher-usgs.github.com

# Pagination (added this line)
paginate: 3

# Settings for comments helper
comments :
  provider : disqus
    disqus :
      short_name : XXXXXXXXXXX

# Settings for analytics helper
analytics :
  provider : google
  google :
    tracking_id : 'XX-XXXXXXXX-X'

Page and Post

Create a page template:

$ rake page name="XXXX.md"

Create a post template:

$ rake post title="XXXX XXXX"

See Markdown Syntax Guide for help with content creation in your favorite text editor.

References

http://jekyllbootstrap.com/lessons/jekyll-introduction.html
http://zolomon.com/tutorial/2012/02/23/setting-up-jekyll-on-windows-7
http://twitter.github.com/bootstrap/index.html