Skip to content

Commit e7260c8

Browse files
authored
Set proper Ruby version and remove version minimum in favor of latest to prevent build errors. (#16964)
1 parent dec90b1 commit e7260c8

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

src/content/docs/pages/migrations/migrating-jekyll-from-github-pages.mdx

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,13 @@ Your existing Jekyll-based repository must specify a `Gemfile` (Ruby's dependenc
4949

5050
Specifically, you will need to create a `Gemfile` and install the `github-pages` gem, which includes all of the dependencies that the GitHub Pages environment assumes.
5151

52+
[Version 2 of the Pages build environment](/pages/configuration/build-image/#languages-and-runtime) will use Ruby 3.2.2 for the default Jekyll build. Please make sure your local development environment is compatible.
53+
54+
```sh title="Set Ruby Version"
55+
brew install [email protected]
56+
export PATH="/usr/local/opt/[email protected]/bin:$PATH"
57+
```
58+
5259
```sh title="Create a Gemfile"
5360
cd my-github-pages-repo
5461
bundle init
@@ -57,7 +64,7 @@ bundle init
5764
Open the `Gemfile` that was created for you, and add the following line to the bottom of the file:
5865

5966
```ruby title="Specifying the github-pages version"
60-
gem "github-pages", "~> 215", group: :jekyll_plugins
67+
gem "github-pages", group: :jekyll_plugins
6168
```
6269

6370
Your `Gemfile` should resemble the below:
@@ -70,7 +77,7 @@ source "https://rubygems.org"
7077
git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
7178

7279
# gem "rails"
73-
gem "github-pages", "~> 215", group: :jekyll_plugins
80+
gem "github-pages", group: :jekyll_plugins
7481
```
7582

7683
Run `bundle update`, which will install the `github-pages` gem for you, and create a `Gemfile.lock` file with the resolved dependency versions.

0 commit comments

Comments
 (0)