This is the website of our academic research group at Durham University.
This website is powered by Jekyll with Bootstrap and Bootswatch. It is based on a template from the Allan Lab.
You can update the website in two ways:
- Edit and commit files one at a time directly in the repository on GitHub.
- Preferred: make all changes locally, run the site locally to verify everything, then push one consolidated commit (or one small commit set) to the
gh-pagesbranch. More details are below.
This repository has a GitHub Actions workflow that automatically builds and deploys the site when changes are pushed to the gh-pages branch.
- Trigger: push to
gh-pages(or manual run from the Actions tab). - Build step:
bundle exec jekyll build. - Deploy step: publishes the generated site to GitHub Pages.
In practice, each push to gh-pages automatically rebuilds and republishes the site.
This repository pins Jekyll to version 4.3.2 in Gemfile, so install dependencies through Bundler from this repo folder.
On Windows, install Ruby+Devkit from RubyInstaller:
Choose a recent Ruby 3.x build with Devkit, then complete the MSYS2 prompt that appears at the end of install.
Open Command Prompt and run:
gem install bundlerFrom the project root (this folder), run:
bundle installThis installs Jekyll 4.3.2 and the exact supporting gems from Gemfile.lock.
To start the website, in the project root (this folder), run:
bundle exec jekyll serveThen open:
While bundle exec jekyll serve is running, local changes are detected and the site is rebuilt automatically. When you are ready to publish updates, commit your changes and push to GitHub (the gh-pages branch).
Close and reopen your terminal after installing Ruby/Bundler, then try again.
This repo lockfile was generated with Bundler 2.3.7. If needed, install that version explicitly:
gem install bundler:2.3.7Copyright Cornish Labs. Code released under the MIT License.