Recently I've been working on some updates and fixes for my personal website, which was running on GitHub Pages using Jekyll 3.9 since the 2015. One of this fixes was implementing the posibility of having open graph images and making it more interesting when posting on social media, using igor-alexandrov/jekyll-og-image plugin.

This plugin requires advanced building because dependencies, so you need to switch to custom workflows instead of keep using the default building system, if you want to make it works. This made me curious about what we are missing here, by keep using gh-pages. So, after modifing my Gemfile to start using new version of Jekyll and remove locked dependencies for GitHub Pages, it ended like this.

source "https://rubygems.org/"

gem "jekyll", "~> 4.4.1"
gem "jekyll-feed", "~> 0.12"
gem "jekyll-paginate"
gem "jekyll-seo-tag"
gem 'jekyll-og-image'

platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", "~> 1.2"
  gem "tzinfo-data"
end

gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
gem "webrick", "~> 1.8"

After this change you will need to run:

bundle update
bundle install

This is for regenerate your Gemfile.lock and being able to install dependencies without errors while running the workflow. Once completed commited to your repository, it be completely free to update to Jekyll 4, use new unsupported plugins, or even create your own!