Repository Instructions

Repository Instructions

This repository is a personal academic website deployed through GitHub Pages. It uses AcademicPages / Minimal Mistakes on Jekyll.

Primary Work

  • Prioritize additions and updates for teaching pages and standalone course websites.
  • Preserve the existing AcademicPages structure unless a change is needed for the teaching/course workflow.
  • Keep plans in plan/ as Markdown files with a date prefix, for example plan/YYYY-MM-DD-topic.md.
  • Track work with Git. Check git status --short --branch before and after edits, and keep unrelated local changes intact.

Local Build

  • Prefer the existing Ruby/Bundler workflow first:
    • bundle install
    • bundle exec jekyll build
    • bundle exec jekyll serve
  • If the system Ruby setup becomes fragile or incompatible, create a standalone conda environment for local builds rather than changing global tooling.
  • Keep generated site output and dependency directories out of commits unless explicitly requested.
  • Local Bundler installs should use an ignored path such as .bundle/ if global native gems are incompatible.

Site Structure Notes

  • Site configuration lives in _config.yml.
  • Top navigation lives in _data/navigation.yml.
  • Standard pages live in _pages/.
  • Blog-style posts live in _posts/.
  • Existing collection examples include _talks/ and the research collection configuration.
  • _layouts/single.html already contains presentation logic for a future teaching collection, but _config.yml does not currently define that collection.