It’s been a decade or two since I’ve updated my website so what better way to update my website by writing an article about updating my website.
I ran into a few snags trying to install Jekyll 3.8.5 on macOS Mojave so I thought I’d document what ended up working in case anyone else is running into the same issues. This post is geared towards non ruby people who are currently using or are interested in using the latest version of jekyll for their website.
Use a ruby version management tool
You might run into some permission issues if you’re using the ruby version Mojave ships with in
/Library/Ruby/Gems/2.3.0/. We want to avoid using sudo whenever possible, I prefer rbenv because it’s lightweight, simple, and I’ve just never had any issues with it. You can easily switch versions of ruby to suit your needs.
Install rbenv with homebrew
brew install rbenv
Once you have rbenv installed, you can then install the latestish version of Ruby:
rbenv install 2.6.1 (*note: this can take a while, the first time running this I thought it had froze but I just had to put my patient pants on)
Then set your ruby version with the following command:
rbenv global 2.6.1
Restart terminal and type
ruby -v, you should see something like:
Now we’re ready to install jekyll!
gem install bundler jekyll
Make sure you’re on the right path
If you use Oh My Zsh you can simply add bundler and rbenv into your plugins array.
This should automatically get the correct paths into your shell. Otherwise make sure your path is set in your .bash_profile/.bashrc/whatever file (i.e.
export PATH="$HOME/.rbenv/bin:$PATH"), optionally you can add
eval "$(rbenv init -)" which will add autocomplation (among other things).
Let’s start a new site!
You should now be able to see your site at http://localhost:4000
Troubleshooting common errors
- If your installation is in a wonky loop run
gem install bundler(in a folder that outside of your project that doesn’t have a gemfile)
- Then run
bundle installin your website’s directory to make sure you have all latest dependencies
I recently moved my site to Netlify because it makes setting up a continuous deployment process pretty painless. When I push my site to github it automatically deploys the updates to the server. It works flawlessly and it’s great not having to fiddle around with a continuous integration service or complex rakefile to handle the deployment.