CLAUDE.md

CLAUDE.md

Site Overview

Academic personal website for Kelsey Moran, built with Jekyll and hosted on GitHub Pages. Based on the academicpages template (fork of Minimal Mistakes theme).

Live at: https://kelseymoran.github.io

Key Files

  • _config.yml — Site-wide settings (author info, collections, plugins)
  • _data/navigation.yml — Top nav bar links (currently: Research, CV)
  • _pages/about.md — Homepage (permalink: /)
  • _pages/publications.md — Research page (permalink: /research/)
  • _pages/teaching.html — Teaching page (permalink: /teaching/, not yet in nav, says “Under Construction”)
  • _teaching/template.md — Blank template for adding teaching entries
  • files/ — PDFs (CV, papers, posters)
  • images/profile.png — Profile photo

How It Works

  • Pages live in _pages/. Collections (teaching, publications) have their own _ directories.
  • Navigation is defined in _data/navigation.yml.
  • The research page uses raw HTML (not the publications collection) for paper listings.
  • The sitemap is auto-generated by jekyll-sitemap on every build.
  • Deployment: push to main and GitHub Pages rebuilds automatically.

Local Development

Requires Ruby via rbenv (installed at ~/.rbenv/versions/3.2.4):

eval "$(rbenv init - zsh)"
bundle exec jekyll serve

Site serves at http://localhost:4000.

Things to Know

  • The _includes/, _layouts/, and _sass/ directories contain theme infrastructure. Avoid editing unless necessary — components are interconnected.
  • Template utility files remain in the repo (README.md, CHANGELOG.md, CONTRIBUTING.md, package.json, _config.dev.yml, LICENSE) but don’t affect the live site.
  • _site/ is in .gitignore — it’s the build output, regenerated on every build.