CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is an academic personal website built on Jekyll using the Academicpages template (a fork of Minimal Mistakes theme). It is hosted on GitHub Pages at https://aperrault.github.io.

Development Commands

# Install dependencies
bundle install

# Serve locally with live reload (runs at localhost:4000)
bundle exec jekyll liveserve

# Clean bundle directory if needed
bundle clean

Content Structure

Collections

_publications/ - Published papers as markdown files (YAML frontmatter: title, authors, venue, paperurl, citation)
_preprints/ - Preprint papers, same format as publications
_pages/ - Main site pages (about.md, publications.md, teaching.md, people.md, contact.md)

File naming convention for publications/preprints

Files use format: YYYY-MM-DD-short-title.md

Static files

files/ - PDFs, BibTeX files, supplementary materials
images/ - Site images and profile photos

Architecture

_config.yml - Main Jekyll configuration (collections, defaults, author info)
_layouts/ - Page templates (default.html is base, single.html for content pages)
_includes/ - Reusable components (author-profile.html, archive-single.html for publication entries)
_sass/ - SCSS styles compiled to assets/css/main.css
_data/navigation.yml - Main navigation menu structure

Adding Publications

Create a markdown file in _publications/ or _preprints/ with date-prefixed filename
Include YAML frontmatter with: title, authors, venue, paperurl (link to PDF), citation
Place PDF in files/ directory
The publication will automatically appear on the publications page via the archive template

Utility Scripts

The markdown_generator/ directory contains Python/Jupyter scripts to batch-generate publication markdown files from TSV data.

Andrew Perrault