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 exampleplan/YYYY-MM-DD-topic.md. - Track work with Git. Check
git status --short --branchbefore and after edits, and keep unrelated local changes intact.
Local Build
- Prefer the existing Ruby/Bundler workflow first:
bundle installbundle exec jekyll buildbundle 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 theresearchcollection configuration. _layouts/single.htmlalready contains presentation logic for a futureteachingcollection, but_config.ymldoes not currently define that collection.