/rszeto.github.io

Build a Jekyll blog in minutes, without touching the command line.

Primary LanguageSCSSMIT LicenseMIT

Ryan Szeto's Personal Website

This is a GitHub Pages website powered by Jekyll.

Requirements

Building and running locally

Dockerfile includes dependencies for running GitHub Pages and building the website's publications. docker-compose.yml specifies two services: (i) jekyll, which runs the website, and (ii) make, which builds the publications for inclusion on the website.

Before building the website, the github-pages Docker image must be built first:

docker build -t github-pages .

Compiling the publications and running the website can be done with one command:

docker-compose up

To compile the publications without running the website, run this command:

docker-compose run make

(Running docker-compose run jekyll should theoretically just run the website, but for some reason, the website is inaccessible when running that command.)

Adding a publication or preprint

To add a publication or preprint, edit the _pub/pubs.bib or _pub/preprints.bib file. Then follow the instructions for building and running locally.

Acknowledgements

Thanks to Starefossen for providing a nice Docker image for running GitHub pages!