axle-h.github.io

ax-h.com

Build dependencies

Requires ruby, node & bundler. Follow the GitHub Pages documentation.

Mac

Everything can be installed from Homebrew.

# Install node
brew install node@14
brew link node@14
npm install -g npm --force
brew install ruby

Ubuntu

The packaged node is a nightmare, I would recommend NodeSource.

# Install ruby
sudo apt install build-essential ruby-full

Install packages

There are two projects:

• npm styles & javascript
• bundle static 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

Run

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/

Build

npm run build
bundle exec jekyll build

TODO

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.