Add GitHub Pages helpful notes#9235
Conversation
| 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 | ||
| 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?
mattr-
left a comment
There was a problem hiding this comment.
This looks good to me. Would you be able to rebase this on top of current master to see if we get clean CI builds? Thank you! 🙇♂️
|
@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. |
mattr-
left a comment
There was a problem hiding this comment.
Thank you! ❤️
@jekyllbot: merge +docs
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.