The following notes are used to update any parts of Jekyll’s technology stack on a Mac OS.
Jekyll is written in Ruby and uses the Liquid template language created by Shopify. Liquid is also written in Ruby.
cloudcannon have a produced a step-by-step tutorial, with examples, that explains the Jekyll file structure and how to use Liquid.
The notes assume that Jekyll has been installed and is running ( for information about installing Jekyll then see Jekyll on macOS ).
All of the following commands are used in a Terminal.
Operating System
Get the current version of the operating system. In this case it is Mac OS. The information will be used to check the package versions that can safely be used to update Jekyll.
Xcode Command Tools
Check the version of Xcode Command Tools that are available then check the installed version:
/Applications/Xcode.app/Contents/Developer/usr/bin/xcodebuild -version #=> Check Xcode version
pkgutil --pkg-info=com.apple.pkg.CLTools_Executables #=> Check installed version
If the Xcode Command Tools need to be updated then the best way is to delete the old version and then install the latest version:
softwareupdate --list #=> Check what software is available
xcode-select -p #=> Find the CommandLineTools folder
sudo rm -rf /Library/Developer/CommandLineTools #=> Delete the old version
xcode-select --install
Check the installed version agains the latest version of Homebrew:
brew --version #=> Check the installed versions of Homebrew
brew update
brew upgrade #=> Upgrade packages
brew doctor #=> Check the status of the installed version
Chruby is a Ruby version manager used with tjis installation. To check the latest version of Ruby:
ruby-install ruby
Check the installed version of Ruby:
ruby --version
ruby-install 3.1.4 #=> Install a specific version
If upgrading the version of Ruby check the that appropriate sections of the shell are updated ( in this case ~/.zrhc ).
RubyGems are part of the Ruby installation.
gem --version
To update the system then:
gem update --system
Check the installed version of Bundler with the latest version:
bundle --version
bundle update --bundler #=> Upgrade to the latest version of Bundler
Check the gem files and if required update them:
bundle check
bundle update jekyll #=> Update a specific gem
bundle update