Skip to content

Latest commit

 

History

History
52 lines (40 loc) · 2.57 KB

File metadata and controls

52 lines (40 loc) · 2.57 KB

Boyle Lab website

This repository contains the source for boylelab.org, a Jekyll site deployed through GitHub Pages.

Sources of truth

Content Authoritative source Generated or rendered output
Publications bibliography/publications.bib and publication_metadata/*.yml _papers/*.yml and pub.bib
Curriculum vitae cv/cv.tex, website publication sources, and cv/patents.bib cv/generated/*.tex and assets/ABoyle_CV.pdf
People _people/*.md /people/ and individual profiles
News _posts/<year>/*.md /news/ and individual stories
Jobs _jobs/*.md /jobs/
Primary pages Root HTML files and news/index.html Public site pages
Shared presentation _layouts/, _includes/, and css/ All rendered pages

Do not edit files in _papers/ or the root pub.bib by hand. They are generated from the BibTeX and sidecar sources.

Common commands

python3 -m pip install -r requirements-publications.txt
bundle install
make publications       # regenerate _papers and pub.bib
make cv                 # regenerate and compile the CV
make check              # verify generated files and run all tests
make build              # regenerate, test, and build _site
make serve              # local Jekyll server with live reload

The equivalent one-command production build is:

scripts/build_site.sh

Documentation

Automated deployment

.github/workflows/site.yml runs automatically only when bibliography/publications.bib changes, then regenerates publications and the CV, runs the test suite, builds the Jekyll site, and deploys it to GitHub Pages. On a direct push, it commits _papers/, pub.bib, cv/generated/, and assets/ABoyle_CV.pdf. The workflow remains available through manual dispatch for other site deployments.