Add GitHub Pages helpful notes #9235
Conversation
| @@ -42,6 +42,11 @@ bundle exec jekyll serve | |||
|
|
|||
| This restricts your Ruby environment to only use gems set in your `Gemfile`. | |||
|
|
|||
| Note: if publishing your site with GitHub Pages, you can match production | |||
| 8000 | version of Jekyll by using the `github-pages` gem instead of `github-pages` | ||
There was a problem hiding this comment.
by using the
github-pagesgem instead ofgithub-pages
in yourGemfile
I... don't understand what this is saying?
There was a problem hiding this comment.
Thank you, fixed at 2621159
|
@mattr- rebased. The build is not reproducible. I compared the build CI logs on Ruby 3.2 for the last successful run to same for this PR. Here's the hint: And the specific problems: -Fetching activesupport 7.0.8
-Installing activesupport 7.0.8
+Using activesupport 7.1.1
+Using bigdecimal 3.1.4
+Using connection_pool 2.4.1
+Using drb 2.1.1
-Fetching mime-types-data 3.2023.0808
-Installing mime-types-data 3.2023.0808
+Using mime-types-data 3.2023.1003
+Using mutex_m 0.1.2
-Fetching rubocop-minitest 0.32.2
-Installing rubocop-minitest 0.32.2
+Fetching rubocop-minitest 0.33.0
+Installing rubocop-minitest 0.33.0
-Fetching sass-embedded 1.68.0 (x86_64-linux-gnu)
-Installing sass-embedded 1.68.0 (x86_64-linux-gnu)
+Fetching sass-embedded 1.69.4 (x86_64-linux-gnu)
+Installing sass-embedded 1.69.4 (x86_64-linux-gnu)
-Fetching thor 1.2.2
-Installing thor 1.2.2
+Fetching thor 1.3.0
+Installing thor 1.3.0A root cause is that our dependencies at underspecified at https://github.com/jekyll/jekyll/blob/8e4ccfc4ff3020633b378ca81e17b8e7adee1a39/Gemfile Another root cause is that apparently some upstream dependency broke the API contract in a minor release. Hypothesis: if any other change is committed in this repo today, by PR or by direct commit, it will fail with the same errors. Here is a PR that fixes this going forward, but does not fix the current problem. |
William Entriken: Add GitHub Pages helpful notes (#9235) Merge pull request 9235
This is a 🔦 documentation change.
Summary
Adds a helpful setup note for people publishing with GitHub Pages.
Context
GitHub Pages will build your project using the
github-pagesgem and without any regard for your repository'sGemfile.lockfile. This PR adds such a note to documentation and advises how you might work with that.