Skip to content

Conversation

@orbeckst
Copy link
Member

  • Gemfile update: ruby >= 2.7 (should now work on Apple silicon and in particular can use ruby 3.x), pinned rdiscount package because of Install error with Xcode 12 beta davidfstr/rdiscount#145
  • add zoneinfo files for Windows (jekyll docs recommendation)
  • add jekyll installation notes in INSTALL (macOS)
  • add file exclusion to _config.yml
  • updated the config author.url to the team pages (instead of twitter)

@orbeckst orbeckst linked an issue Feb 27, 2025 that may be closed by this pull request
@orbeckst
Copy link
Member Author

orbeckst commented Feb 27, 2025

For reference, this is my Gemfile.lock

GEM
  remote: https://rubygems.org/
  specs:
    activesupport (8.0.1)
      base64
      benchmark (>= 0.3)
      bigdecimal
      concurrent-ruby (~> 1.0, >= 1.3.1)
      connection_pool (>= 2.2.5)
      drb
      i18n (>= 1.6, < 2)
      logger (>= 1.4.2)
      minitest (>= 5.1)
      securerandom (>= 0.3)
      tzinfo (~> 2.0, >= 2.0.5)
      uri (>= 0.13.1)
    addressable (2.8.7)
      public_suffix (>= 2.0.2, < 7.0)
    base64 (0.2.0)
    benchmark (0.4.0)
    bigdecimal (3.1.9)
    coffee-script (2.4.1)
      coffee-script-source
      execjs
    coffee-script-source (1.12.2)
    colorator (1.1.0)
    commonmarker (0.23.11)
    concurrent-ruby (1.3.5)
    connection_pool (2.5.0)
    csv (3.3.2)
    dnsruby (1.72.3)
      base64 (~> 0.2.0)
      simpleidn (~> 0.2.1)
    drb (2.2.1)
    em-websocket (0.5.3)
      eventmachine (>= 0.12.9)
      http_parser.rb (~> 0)
    ethon (0.16.0)
      ffi (>= 1.15.0)
    eventmachine (1.2.7)
    execjs (2.10.0)
    faraday (2.12.2)
      faraday-net_http (>= 2.0, < 3.5)
      json
      logger
    faraday-net_http (3.4.0)
      net-http (>= 0.5.0)
    ffi (1.17.1-aarch64-linux-gnu)
    ffi (1.17.1-aarch64-linux-musl)
    ffi (1.17.1-arm-linux-gnu)
    ffi (1.17.1-arm-linux-musl)
    ffi (1.17.1-arm64-darwin)
    ffi (1.17.1-x86_64-darwin)
    ffi (1.17.1-x86_64-linux-gnu)
    ffi (1.17.1-x86_64-linux-musl)
    forwardable-extended (2.6.0)
    gemoji (4.1.0)
    github-pages (232)
      github-pages-health-check (= 1.18.2)
      jekyll (= 3.10.0)
      jekyll-avatar (= 0.8.0)
      jekyll-coffeescript (= 1.2.2)
      jekyll-commonmark-ghpages (= 0.5.1)
      jekyll-default-layout (= 0.1.5)
      jekyll-feed (= 0.17.0)
      jekyll-gist (= 1.5.0)
      jekyll-github-metadata (= 2.16.1)
      jekyll-include-cache (= 0.2.1)
      jekyll-mentions (= 1.6.0)
      jekyll-optional-front-matter (= 0.3.2)
      jekyll-paginate (= 1.1.0)
      jekyll-readme-index (= 0.3.0)
      jekyll-redirect-from (= 0.16.0)
      jekyll-relative-links (= 0.6.1)
      jekyll-remote-theme (= 0.4.3)
      jekyll-sass-converter (= 1.5.2)
      jekyll-seo-tag (= 2.8.0)
      jekyll-sitemap (= 1.4.0)
      jekyll-swiss (= 1.0.0)
      jekyll-theme-architect (= 0.2.0)
      jekyll-theme-cayman (= 0.2.0)
      jekyll-theme-dinky (= 0.2.0)
      jekyll-theme-hacker (= 0.2.0)
      jekyll-theme-leap-day (= 0.2.0)
      jekyll-theme-merlot (= 0.2.0)
      jekyll-theme-midnight (= 0.2.0)
      jekyll-theme-minimal (= 0.2.0)
      jekyll-theme-modernist (= 0.2.0)
      jekyll-theme-primer (= 0.6.0)
      jekyll-theme-slate (= 0.2.0)
      jekyll-theme-tactile (= 0.2.0)
      jekyll-theme-time-machine (= 0.2.0)
      jekyll-titles-from-headings (= 0.5.3)
      jemoji (= 0.13.0)
      kramdown (= 2.4.0)
      kramdown-parser-gfm (= 1.1.0)
      liquid (= 4.0.4)
      mercenary (~> 0.3)
      minima (= 2.5.1)
      nokogiri (>= 1.16.2, < 2.0)
      rouge (= 3.30.0)
      terminal-table (~> 1.4)
      webrick (~> 1.8)
    github-pages-health-check (1.18.2)
      addressable (~> 2.3)
      dnsruby (~> 1.60)
      octokit (>= 4, < 8)
      public_suffix (>= 3.0, < 6.0)
      typhoeus (~> 1.3)
    html-pipeline (2.14.3)
      activesupport (>= 2)
      nokogiri (>= 1.4)
    http_parser.rb (0.8.0)
    i18n (1.14.7)
      concurrent-ruby (~> 1.0)
    jekyll (3.10.0)
      addressable (~> 2.4)
      colorator (~> 1.0)
      csv (~> 3.0)
      em-websocket (~> 0.5)
      i18n (>= 0.7, < 2)
      jekyll-sass-converter (~> 1.0)
      jekyll-watch (~> 2.0)
      kramdown (>= 1.17, < 3)
      liquid (~> 4.0)
      mercenary (~> 0.3.3)
      pathutil (~> 0.9)
      rouge (>= 1.7, < 4)
      safe_yaml (~> 1.0)
      webrick (>= 1.0)
    jekyll-avatar (0.8.0)
      jekyll (>= 3.0, < 5.0)
    jekyll-coffeescript (1.2.2)
      coffee-script (~> 2.2)
      coffee-script-source (~> 1.12)
    jekyll-commonmark (1.4.0)
      commonmarker (~> 0.22)
    jekyll-commonmark-ghpages (0.5.1)
      commonmarker (>= 0.23.7, < 1.1.0)
      jekyll (>= 3.9, < 4.0)
      jekyll-commonmark (~> 1.4.0)
      rouge (>= 2.0, < 5.0)
    jekyll-default-layout (0.1.5)
      jekyll (>= 3.0, < 5.0)
    jekyll-feed (0.17.0)
      jekyll (>= 3.7, < 5.0)
    jekyll-gist (1.5.0)
      octokit (~> 4.2)
    jekyll-github-metadata (2.16.1)
      jekyll (>= 3.4, < 5.0)
      octokit (>= 4, < 7, != 4.4.0)
    jekyll-include-cache (0.2.1)
      jekyll (>= 3.7, < 5.0)
    jekyll-mentions (1.6.0)
      html-pipeline (~> 2.3)
      jekyll (>= 3.7, < 5.0)
    jekyll-optional-front-matter (0.3.2)
      jekyll (>= 3.0, < 5.0)
    jekyll-paginate (1.1.0)
    jekyll-readme-index (0.3.0)
      jekyll (>= 3.0, < 5.0)
    jekyll-redirect-from (0.16.0)
      jekyll (>= 3.3, < 5.0)
    jekyll-relative-links (0.6.1)
      jekyll (>= 3.3, < 5.0)
    jekyll-remote-theme (0.4.3)
      addressable (~> 2.0)
      jekyll (>= 3.5, < 5.0)
      jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0)
      rubyzip (>= 1.3.0, < 3.0)
    jekyll-sass-converter (1.5.2)
      sass (~> 3.4)
    jekyll-seo-tag (2.8.0)
      jekyll (>= 3.8, < 5.0)
    jekyll-sitemap (1.4.0)
      jekyll (>= 3.7, < 5.0)
    jekyll-swiss (1.0.0)
    jekyll-theme-architect (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-cayman (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-dinky (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-hacker (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-leap-day (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-merlot (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-midnight (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-minimal (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-modernist (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-primer (0.6.0)
      jekyll (> 3.5, < 5.0)
      jekyll-github-metadata (~> 2.9)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-slate (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-tactile (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-theme-time-machine (0.2.0)
      jekyll (> 3.5, < 5.0)
      jekyll-seo-tag (~> 2.0)
    jekyll-titles-from-headings (0.5.3)
      jekyll (>= 3.3, < 5.0)
    jekyll-watch (2.2.1)
      listen (~> 3.0)
    jemoji (0.13.0)
      gemoji (>= 3, < 5)
      html-pipeline (~> 2.2)
      jekyll (>= 3.0, < 5.0)
    json (2.10.1)
    kramdown (2.4.0)
      rexml
    kramdown-parser-gfm (1.1.0)
      kramdown (~> 2.0)
    liquid (4.0.4)
    listen (3.9.0)
      rb-fsevent (~> 0.10, >= 0.10.3)
      rb-inotify (~> 0.9, >= 0.9.10)
    logger (1.6.6)
    mercenary (0.3.6)
    minima (2.5.1)
      jekyll (>= 3.5, < 5.0)
      jekyll-feed (~> 0.9)
      jekyll-seo-tag (~> 2.1)
    minitest (5.25.4)
    net-http (0.6.0)
      uri
    nokogiri (1.18.3-aarch64-linux-gnu)
      racc (~> 1.4)
    nokogiri (1.18.3-aarch64-linux-musl)
      racc (~> 1.4)
    nokogiri (1.18.3-arm-linux-gnu)
      racc (~> 1.4)
    nokogiri (1.18.3-arm-linux-musl)
      racc (~> 1.4)
    nokogiri (1.18.3-arm64-darwin)
      racc (~> 1.4)
    nokogiri (1.18.3-x86_64-darwin)
      racc (~> 1.4)
    nokogiri (1.18.3-x86_64-linux-gnu)
      racc (~> 1.4)
    nokogiri (1.18.3-x86_64-linux-musl)
      racc (~> 1.4)
    octokit (4.25.1)
      faraday (>= 1, < 3)
      sawyer (~> 0.9)
    pathutil (0.16.2)
      forwardable-extended (~> 2.6)
    public_suffix (5.1.1)
    racc (1.8.1)
    rb-fsevent (0.11.2)
    rb-inotify (0.11.1)
      ffi (~> 1.0)
    rdiscount (2.2.7.3)
    rexml (3.4.1)
    rouge (3.30.0)
    rubyzip (2.4.1)
    safe_yaml (1.0.5)
    sass (3.7.4)
      sass-listen (~> 4.0.0)
    sass-listen (4.0.0)
      rb-fsevent (~> 0.9, >= 0.9.4)
      rb-inotify (~> 0.9, >= 0.9.7)
    sawyer (0.9.2)
      addressable (>= 2.3.5)
      faraday (>= 0.17.3, < 3)
    securerandom (0.4.1)
    simpleidn (0.2.3)
    terminal-table (1.8.0)
      unicode-display_width (~> 1.1, >= 1.1.1)
    typhoeus (1.4.1)
      ethon (>= 0.9.0)
    tzinfo (2.0.6)
      concurrent-ruby (~> 1.0)
    unicode-display_width (1.8.0)
    uri (1.0.3)
    webrick (1.9.1)

PLATFORMS
  aarch64-linux-gnu
  aarch64-linux-musl
  arm-linux-gnu
  arm-linux-musl
  arm64-darwin
  x86_64-darwin
  x86_64-linux-gnu
  x86_64-linux-musl

DEPENDENCIES
  github-pages
  rdiscount (>= 2.2.0.2)
  rouge
  tzinfo (>= 1, < 3)
  tzinfo-data
  webrick (~> 1.7)

RUBY VERSION
   ruby 3.4.1p0

BUNDLED WITH
   2.6.2

- Gemfile update: ruby >= 2.7 (should now work on Apple silicon
  and in particular can use ruby 3.x), pinned rdiscount package
  because of davidfstr/rdiscount#145
- add zoneinfo files for Windows (jekyll docs recommendation)
- add jekyll installation notes in INSTALL (macOS)
- add file exclusion to _config.yml
- updated the config author.url to the team pages (instead of twitter)
@orbeckst orbeckst linked an issue Feb 27, 2025 that may be closed by this pull request
Copy link
Contributor

@marinegor marinegor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@orbeckst I'm not qualified enough in managing ruby dependencies (I simply googled how to make the fix I did), but I'm fine with your changes as long as they produce the same website, which they seem to.

@orbeckst
Copy link
Member Author

I don't do ruby either but if you tested it and it worked then that's good.

@namiroues could you give it a try? Which OS are you using?

@namiroues
Copy link
Contributor

@orbeckst I'm running mac 15.3.1. I tried to build your branch and had the following issues:

  • The jekyll docker image specified in the docs (3.8) supports ruby 2.6 so it would not build.
  • I switched to the next version which is 4.0.0 and faced the ffi issue mentioned in Suggested Docker build doesn't work.  #410 so I added gem "ffi", "=1.16.3" to the Gemfile.
  • After doing that, dependencies are installed but the docker image exits without creating the _site directory, so something else is failing.

Until this is fixed, perhaps #433 can be merged?

@orbeckst
Copy link
Member Author

Can you try without docker and directly install? This works so much better in jekyll serve mode. Docker is extremely cluncky (I hate it with a passion anyway...)

@orbeckst
Copy link
Member Author

I just merged PR #433 based on your confirmation.

@orbeckst
Copy link
Member Author

Yes, admittedly, this change will not work with the docker image:

Your Ruby version is 2.6.3, but your Gemfile specified >= 2.7, < 4

updated README and INSTALL
@orbeckst
Copy link
Member Author

I tested with

rm -rf _site
export JEKYLL_VERSION=4.0
docker run --rm   --volume="$PWD:/srv/jekyll"   -it jekyll/jekyll:$JEKYLL_VERSION   jekyll build --future

on my x86 mac and it worked for me. The _site is built and I can see it when http-serving.

@orbeckst orbeckst requested a review from RMeli February 27, 2025 23:06
@orbeckst orbeckst linked an issue Feb 27, 2025 that may be closed by this pull request
@orbeckst
Copy link
Member Author

orbeckst commented Mar 1, 2025

@hmacdope you had complained about jekyll in the past. Could you please check if the updated instructions work for you?

@orbeckst
Copy link
Member Author

orbeckst commented Mar 1, 2025

@marinegor can I please leave it to you to look after the PR? I'd say if there are no objections within the next 5d you can merge it based on 1 approval.

@marinegor
Copy link
Contributor

@orbeckst sure, I'll merge on Thursday, if there are no objections.

@marinegor marinegor merged commit b1af62d into master Mar 6, 2025
1 check passed
@marinegor marinegor deleted the update-gemfile branch March 6, 2025 23:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

Suggested Docker build doesn't work. Update ruby and webricks to latest

4 participants