This Jekyll blog theme is based on The-MVM (which on its turn is based on Adam-blog and further adapted for the UB Maastricht use case.
The theme fully compliant with GitHub pages and can be deployed using GitHub actions.
Install the required packages as described in the Jekyll docs. For convenience, these are the steps in Ubuntu:
Install Ruby
sudo apt-get install ruby-full build-essential zlib1g-dev
Aset up a gem installation directory for your user account
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Install Jekyll and Bundler
gem install jekyll bundler
Install the site's dependencies from the Gemfile
Change directory to the folder where this repo and the Gemfile is located.
cd /path/to/this/workdir
Install Gems from Gemfile with
bundle install
Start the site with
bundle exec jekyll serve
Access the site at http://localhost:4000
More details about Jekyll, the folder structure and workings can be found in the MVM readme.