Requires ruby, node & bundler. Follow the GitHub Pages documentation.
Everything can be installed from Homebrew.
# Install node brew install node@14 brew link node@14 npm install -g npm --force brew install ruby
The packaged node is a nightmare, I would recommend NodeSource.
# Install ruby sudo apt install build-essential ruby-full
There are two projects:
bundlestatic site generation with jekyll
# Install bundler gem install bundler # Run npm install and bundle install bundle config set --local path 'vendor/bundle' bundle install npm install
Then in two separate terminals run webpack and jekyl (in that order!) with:
npm run watch
bundle exec jekyll serve
Browse to http://localhost:4000/
npm run build bundle exec jekyll build
I am aware that the CSS library I've used to build this site is dead and has some open CVE's. I'm not using any features affected but ergh. Maybe I will port it all to Bootstrap 5 for fun when that comes out I don't know.