This is the repo for the pdxhackerspace.org site, served using GitHub Pages. The site is built with Jekyll from HTML snippets, includes, and front matter.

Use the same Jekyll and Ruby versions GitHub Pages runs in production. The github-pages gem pins those for you.

• Ruby 3.3.x (see GitHub Pages dependency versions)
• Bundler

Install Ruby 3.3 if needed. With rbenv:

rbenv install 3.3.4
rbenv local 3.3.4

Or with RVM:

rvm install 3.3.4
rvm use 3.3.4

Install gems:

gem install bundler
bundle install

bundle exec jekyll serve

Open http://127.0.0.1:4000. Jekyll watches for changes and rebuilds automatically.

To match production more closely:

bundle exec jekyll serve --safe

When GitHub Pages updates its build environment, refresh local gems with:

bundle update github-pages

Check the live pinned versions at https://pages.github.com/versions.json