/wychowlab-web

Wing Ying Chow (Warwick, UK) lab website. Using magnetic resonance to deliver new insight to human health and disease.

Primary LanguageTeXOtherNOASSERTION

Website for Wing Ying Chow's Lab at University of Warwick, UK

https://wychowlab.org/

Background

This is a Jekyll-based Web site based on the work of the sampa group at the University of Washington. It was forked from this repository and detached after significant modifications.

This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.

Modifications from uwsampa template

  • adapted and optimized the build process for GitHub Pages
  • improved .gitignore using Toptal's gitignore tool
  • added Gemfile for a consistent Jekyll build environment using Bundler
  • added jekyll-seo-tag plugin, mostly for improved Twitter cards
  • added jekyll-feed and jekyll-sitemap plugins
  • updated from [Bootstrap][] 3 to 5
  • updated from [Font Awesome][fa] 4 to 6, originally for the ORCID logo, but possibly now more for the fun effects
  • updated from jQuery 3.5.1 to 3.6.1
  • added favicon generated from fontawesome
  • used pylatexenc to convert LaTeX-encoded parts of website back to text
  • refactored parts of default.html/index.html as includes
  • typography: test with Fontjoy, served with Google web fonts
  • implemented some accessibility provisions such as alt tags for images and screen readers (aria)
  • renamed master to main (see github/renaming)
  • removed "faculty" as being used for a single-PI lab website
  • added lightbox
  • implemented a covers gallery on the publication page
  • implemented checking for broken links using html-proofer (gem)

Building

The requirements for building the site are:

  • Bundler: run gem install bundler
  • Jekyll: run gem install jekyll
  • gems listed in the Gemfile - though you can comment out parts you don't need
  • bibble: available on pip
  • ssh and rsync, only if you want to deploy directly.

make compiles the bibliography and the website content to the docs directory. To preview the site, run make serve and head to http://localhost:4000.

Deploying to GitHub Pages

This template is optimized for hosting the site on GitHub Pages using a custom domain in CNAME. You can pick which branch you deploy the site on. A new commit/push to GitHub will trigger a rebuild.