First Post – Setting Up GitHub Pages

First Post – Setting Up GitHub Pages

2017, Nov 03    

I’ve finally come around to getting this going with motivation from CJ. It’s pretty cool how smoothly the setup process can be (though there’s always a few hiccups as with anything). Nowadays much of the back-end stuff is taken care of as a black-box. Even though I didn’t have others help, I wouldn’t consider this “building” my own website. This blog post is just a markdown file that will get converted to HTML by kramdown/Jekyll. Not going into any details here, as others have already said enough.

I found this theme through a quick google search and stuck with it for the minimalist design.

Here’s the catch… earlier this year, I had tried to get GitHub Pages running with the built-in version of ruby on macOS. Bad idea. I must have ran sudo gem install jekyll bundle so running jekyll serve works fine on my machine, but gem install was not behaving correctly without root permissions.

Detecting that I had the wrong ruby version:

$ which ruby
$ ruby -v
ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15]

GitHub Pages requires ruby >=2.1.0. Attempting to install via Homebrew following this guide:

$ brew install gnupg
$ gpg --keyserver hkp:// --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
gpg: directory '/Users/Victor/.gnupg' created
gpg: keybox '/Users/Victor/.gnupg/pubring.kbx' created
gpg: keyserver receive failed: No route to host

This error is easily fixed by following the direction on RVM install page.

$ gpg --keyserver hkp:// --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Install RVM:

$ curl -sSL | bash -s stable --ruby
$ source ~/.rvm/scripts/rvm
$ which rvm

Looks like the correct ruby is installed and being used. Also be sure to add that final source command to your respective .bash_profile. Check ruby version:

$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-darwin15]

Looks good! Install necessary gems:

$ gem install jekyll bundler

Add a Gemfile to install required gems for the blog:

source ''
gem 'github-pages'
gem 'jekyll-paginate'

Finish the install using bundle install. Run jekyll serve to preview and navigate the entire site on a local machine. git commit, git push, and we’re here!