Note Ruby incompability with Jekyll for GitHub Pages

david-kudlacek · david-kudlacek · commit 7f80f1320655 · 2026-06-18T13:42:51.000+02:00
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md
@@ -54,6 +54,8 @@ Before you can use Jekyll to test a site, you must:
    >
    >   To fix the error, try running `bundle add webrick`, then re-running `bundle exec jekyll serve`.
    >
+   >   You might get other errors (related to missing gems and deprecated methods) if you've installed Ruby 3.2 or later. It is recommended to install Ruby 3.1.x or earlier instead due to compatibility issues with the `github-pages` gem.
+   >
    > * If your `_config.yml` file's `baseurl` field contains your GitHub repository's link, you can use the following command when building locally to ignore that value and serve the site on `localhost:4000/`:
    >
    >   ```shell

Original file line number	Diff line number	Diff line change
`@@ -54,6 +54,8 @@ Before you can use Jekyll to test a site, you must:`
`54`	`54`	`>`
`55`	`55`	> To fix the error, try running `bundle add webrick`, then re-running `bundle exec jekyll serve`.
`56`	`56`	`>`
	`57`	+ > You might get other errors (related to missing gems and deprecated methods) if you've installed Ruby 3.2 or later. It is recommended to install Ruby 3.1.x or earlier instead due to compatibility issues with the `github-pages` gem.
	`58`	`+ >`
`57`	`59`	> * If your `_config.yml` file's `baseurl` field contains your GitHub repository's link, you can use the following command when building locally to ignore that value and serve the site on `localhost:4000/`:
`58`	`60`	`>`
`59`	`61`	> ```shell