• Home
  • About
    • About Me

      I am a technologist, manager, father and soccer fan. At Appian, I manage front-end web and mobile engineers building cutting edge features. At home, I help my wonderful wife raise our 2 crazy boys. In my spare time I root for Manchester City, read, travel, and geek out on technology.

    • My Resume
    • Twitter
    • LinkedIn
    • Github
  • Posts
    • All Posts
    • All Tags
  • Projects
  • Wishlist
  • Must Read

How to Setup Github Pages on OSX Mavericks

10 Apr 2014

Reading time ~1 minute

I recently re-installed my operating system. Re-installing most of my applications was a matter of downloading, unpacking and clicking.

This blog runs on Github Pages. In order to test posts before comming them to Github, I need to have something called Jekyll and a bunch of other development tools installed on my machine. Installing all of that was not so easy. Github provides pretty good instructions on Installing Jekyll. However their site is not 100% accurate. After a lot of Googling, I finally found a combination of steps that worked. I’m writing them here in case it helps someone else.

Instructions

  1. Install the XCode app from the App Store
  2. Open XCode after installation to complete the full installation
  3. Install XCode Developer Tools by running xcode-select --install (1)
  4. Complete steps 1 and 2 on Github page: Installing Jekyll
  5. Do the first part of step 3, create the Gemfile as
    source 'https://rubygems.org'
    gem 'github-pages'
    
  6. Then instead of running bundle install, run sudo ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future bundle install

Why? Well, it turns out that the latest version of Xcode ships with a compiler that treats unknown passed parameters as errors and the ARCHFLAGS fixes that (2).

If all goes well, it will install a whole bunch of gems and complete successfully.