beeldengeluid / mediasuite-website

Frontend code repository for the CLARIAH Media Suite website.
https://mediasuite.clariah.nl
0 stars 0 forks source link

Remove deprecated Github Pages gem, so Jekyll won't be held back on version 3 #26

Closed frankstrater closed 5 months ago

frankstrater commented 6 months ago

Note: document how to uninstall gems globally on any OS/env

frankstrater commented 6 months ago

Check history of Gemfile:

https://github.com/beeldengeluid/mediasuite-website/commits/main/Gemfile

Test uninstalling all gems (dry run) and then uninstall:

gem cleanup --dry-run gem cleanup

Reinstall bundler and jekyll:

gem install bundler jekyll

Generate default Gemfile by creating new site:

jekyll new my-awesome-site

Copy and merge Gemfile. Check all existing plugins and new plugins....

# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
#
#     bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
gem "jekyll", "~> 4.3.3"
# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.5"
# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
# gem "github-pages", group: :jekyll_plugins
# If you have any plugins, put them here!
group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.12"
end

# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", ">= 1", "< 3"
  gem "tzinfo-data"
end

# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]

# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
# do not have a Java counterpart.
gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]
frankstrater commented 6 months ago

Updated Gemfile:

source 'https://rubygems.org'
gem "jekyll", "~> 4.3.3"

group :jekyll_plugins do
  gem "jekyll-tidy"
end

# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", ">= 1", "< 3"
  gem "tzinfo-data"
end

# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]

# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
# do not have a Java counterpart.
gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]

Install bundle:

bundle install

Build & run:

bundle exec jekyll serve

frankstrater commented 6 months ago

Test complete, but SASS deprecation warning on Bootstrap 4.6.1

frank@L348:~/projects/mediasuite-website$ bundle exec jekyll serve
Configuration file: /home/frank/projects/mediasuite-website/_config.yml
            Source: /home/frank/projects/mediasuite-website
       Destination: /home/frank/projects/mediasuite-website/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
Deprecation Warning: Passing percentage units to the global abs() function is deprecated.
In the future, this will emit a CSS abs() function to be resolved by the browser.
To preserve current behavior: math.abs(100%)
To emit a CSS abs() now: abs(#{100%})
More info: https://sass-lang.com/d/abs-percent

   ╷
54 │   $dividend: abs($dividend);
   │              ^^^^^^^^^^^^^^
   ╵
    /home/frank/projects/mediasuite-website/_sass/bootstrap/scss/vendor/_rfs.scss 54:14             divide()
    /home/frank/projects/mediasuite-website/_sass/bootstrap/scss/mixins/_grid.scss 66:15            row-cols()
    /home/frank/projects/mediasuite-website/_sass/bootstrap/scss/mixins/_grid-framework.scss 43:13  @content
    /home/frank/projects/mediasuite-website/_sass/bootstrap/scss/mixins/_breakpoints.scss 65:5      media-breakpoint-up()
    /home/frank/projects/mediasuite-website/_sass/bootstrap/scss/mixins/_grid-framework.scss 32:5   make-grid-columns()
    /home/frank/projects/mediasuite-website/_sass/bootstrap/scss/_grid.scss 72:3                    @import
    /home/frank/projects/mediasuite-website/_sass/bootstrap/scss/bootstrap.scss 16:9                @import
    custom.scss 44:9                                                                                @import
    /home/frank/projects/mediasuite-website/assets/css/main.scss 1:9                                root stylesheet
                    done in 4.428 seconds.
 Auto-regeneration: enabled for '/home/frank/projects/mediasuite-website'
    Server address: http://127.0.0.1:4000
  Server running... press ctrl-c to stop.