How to install github pages with jekyll

1

I was following the instructions here: https://help.github.com/en/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll#creating-your-site

and then I tried the commands but I get errors. It says

Update the gem "github-pages" line so that the line looks like this, 
replacing VERSION with the current dependency version for github-pages. 
For more information, see "Dependency versions" on the GitHub Pages site.

gem "github-pages", "~> VERSION", group: :jekyll_plugins

but I get the error:

$ bundle install
Fetching gem metadata from https://rubygems.org/...........
Fetching gem metadata from https://rubygems.org/.
Could not find gem 'github-pages (~> 3.8.5)' in any of the gem sources listed in your Gemfile.

when I use:

gem "github-pages", "~> 3.8.5", group: :jekyll_plugins

How do I fix this?

My gemfile:

source "https://rubygems.org"
# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
#
#     bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
# gem "jekyll", "~> 4.0.0"
# gem "jekyll", "~> 3.8.5"
# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.5"
gem "jekyll-athena"

# Seems this is needed to install a lot of subcommands, see: https://github.com/jekyll/jekyll-compose
gem 'jekyll-compose', group: [:jekyll_plugins]

# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
#gem "github-pages", group: :jekyll_plugins
# gem "github-pages", "~> jekyll 3.8.5", group: :jekyll_plugins
gem "github-pages", "~> 3.8.5", group: :jekyll_plugins
#gem "jekyll", "~> 3.8.5"

# If you have any plugins, put them here!
group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.12"
end

# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
  gem "tzinfo", "~> 1.2"
  gem "tzinfo-data"
end

# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :install_if => Gem.win_platform?
2

related:

3

Hi. The versions for the github-pages gem are different than for the Jekyll gem.

To look up a gem’s versions, use RubyGems.org.

Here are the versions for github-pages: https://rubygems.org/gems/github-pages

The latest version is 202, so you’d put:

gem "github-pages", "202"

With each new release (you can watch the github/pages-gem repo for releases if you want to be notified when new ones are released), just replace the "202" with the new version in quotes.

Hope this helps.

1 Like
4

Awesome! I think this nearly solves my issue. Now my Gemfile doesn’t work cuz it has the following error:

$ bundle install
Fetching gem metadata from https://rubygems.org/...........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Bundler could not find compatible versions for gem "jekyll-feed":
  In Gemfile:
    jekyll-feed (~> 0.12)

    github-pages (= 202) was resolved to 202, which depends on
      jekyll-feed (= 0.11.0)

my Gemfile is:

source "https://rubygems.org"
# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
#
#     bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
# gem "jekyll", "~> 4.0.0"
# gem "jekyll", "~> 3.8.5"
# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.5"
gem "jekyll-athena"

# Seems this is needed to install a lot of subcommands, see: https://github.com/jekyll/jekyll-compose
gem 'jekyll-compose', group: [:jekyll_plugins]

# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
# gem "github-pages", group: :jekyll_plugins
# for jekyll 3.8.5
gem "github-pages", "202", group: :jekyll_plugins

# If you have any plugins, put them here!
group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.12"
end

# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
  gem "tzinfo", "~> 1.2"
  gem "tzinfo-data"
end

# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :install_if => Gem.win_platform?

thanks for the help!

5

"Bundler could not find compatible versions for gem “jekyll-feed”:
In Gemfile:
jekyll-feed (~> 0.12)

github-pages (= 202) was resolved to 202, which depends on
  jekyll-feed (= 0.11.0)"

Above error message seems to describe that github-pages (= 202) depends on jekyll-feed (= 0.11.0). please try to adjust the version of jekyll-feed. Hope it is helpful.

For more information, see “Dependency versions” on the GitHub Pages site.

1 Like