Go to workshop website

The design is based on Hyde by Mark Otto. The instructions assume you manage your Ruby installation with rvm.

# install required software (if you're using a different system, consider deleting Gemfile.lock for a working configuration)
# rvm install ruby-2.7 --with-openssl-dir=$HOME/.rvm/usr (on Ubuntu 22.04, see https://stackoverflow.com/questions/72179373/cant-install-ruby-via-rvm-error-running-rvm-make-j4-on-ubuntu-22-04)
# bundle install

rvm use ruby-2.7

bundle exec jekyll serve # build the site

A generic "Fork me" ribbon has been added and can be configured (text, link) in the file _config.yml. The color is configured in public/css/agile.css. The ribbon appears on all pages via _layouts/default.html, and stylesheets are included in _includes/head_default.html if enabled.

If you do not want a page to appear in the left hand side menu, include the parameter exclude_from_nav: true in the page's frontmatter.

External CDN links were replaced with local copies as follows:

• https://cdnjs.cloudflare.com/ajax/libs/anchor-js/3.2.1/anchor.min.js saved to public/js/
• https://cdnjs.cloudflare.com/ajax/libs/github-fork-ribbon-css/0.2.0/gh-fork-ribbon.min.css saved to public/css/ (same for IE9 variant .ie.min.css)

Google Fonts stored locally using https://google-webfonts-helper.herokuapp.com. Font Awesome manually downloaded from https://fontawesome.com/v4.7.0/.