Ruby (for Jekyll)

[CONTENT NEEDED]

Installing for MacOS

My primary development machine is running MacOS. I've heard that things aren't as easy on Windows. I'll add the Windows instructions shortly after the work to launch JekyllFaces is done. I want to verify all the steps myself and kick the tires a bit before suggesting that you go down that road.

Install Homebrew

Homebrew makes installing development-ish software on the Mac easier.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install a Version Manager

The Jekyll site recommends chruby for Ruby version management. I prefer rvm. But we'll go with the suggested tool here. To install chruby, run the following command.

brew install chruby ruby-install xz

Install Ruby

Install the latest stable version of Ruby that's supported by Jekyll. This step may take some time.

ruby-install ruby 3.1.3

Configure Your Shell

Run the commands for your shell to automatically use chruby.

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc
echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc
echo "chruby ruby-3.2.2" >> ~/.zshrc # run 'chruby' to see actual version

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.bash_profile
echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.bash_profile
echo "chruby ruby-3.2.2" >> ~/.bash_profile # run 'chruby' to see actual version

Verify Your Work

Let's make sure that everything is configured as needed for using Jekyll.

$ ruby --version
ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-darwin22]

Troubleshooting

The steps listed above are best performed on a machine that hasn't used Ruby in the past. MacOS comes with an older version of Ruby, so you're encouraged to install the latest Ruby if possible.

Last modified: 15 June 2024