Install dependencies

Install Homebrew:

  • ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install RVM:

  • Disable Documentation to speed up the download:
    • $ echo "gem: --no-document" >> ~/.gemrc
  • Install RVM:
    • $ curl -L https://get.rvm.io | bash -s stable --auto-dotfiles --autolibs=enable --rails
    • quit and relaunch terminal
    • Check that RVM is successfully installed: $ type rvm | head -1
  • Check which Ruby you’re using:
    • $ which ruby
    • /Users/bluefiresweetly/.rvm/rubies/ruby-2.2.1/bin/ruby
    • Should be your own, not system version

Install GIT

  • Assume you already have this.
    • If not, sadness.

Install & Run Jekyll

Install Jekyll

  • $ gem install jekyll

Create Jekyll Site

  • Change to appropriate directory you want to host your directory with your site (so one level up):
    • $ cd ~/sites/
  • Create the new site
    • $ jekyll new my_site (whilst in ~/sites/ for example)
  • Build jekyll site:
    • $ jekyll build --watch (also: jekyll build if you want to build manually each time)
  • Serve it:
    • $ jekyll serve
    • You should see something like: Server address: http://127.0.0.1:4000/ which is where you can access your site
    • If you want to be able to access from say, a mobile device on the same network use: jekyll serve --host=0.0.0.0 then access from your IP (say http://123.456.7.8:4000);

Setup Browser Auto Refresh

  • You can try Live Reload but it’s a bit troublesome to install and not guaranteed to work in Jekyll 2.0+.
  • If you use Sublime Editor, recommend instead to install “Browser Refresh” with Sublime Editor
  • Takes all of 15 seconds to install if you use Package Control.
  • Reference: http://www.hongkiat.com/blog/sublime-text-refresh-browser/
  • cmd+shift+R → auto refresh active tab
  • Recommend these settings (note activate is false since I use dual monitors)
 [
	{
	  "keys": ["super+shift+r"], "command": "browser_refresh", "args": {
		"auto_save": true,
		"delay": 0.0,
		"activate": false,
		"browsers" : ["chrome"]
	  }
	}
  ]