The following notes were made while building this blog; source code is available here.
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.
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 email@example.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.
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.
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.
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.