CLAUDE.md

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

Development Commands

Local Development

• bundle install - Install Ruby dependencies
• bundle exec jekyll serve - Serve site locally at localhost:4000 with auto-reload
• bundle exec jekyll liveserve - Alternative serve command mentioned in README
• bundle clean - Clean up directory before installing

Build and Minification

• npm run build:js - Build and minify JavaScript files
• npm run uglify - Minify JS files into main.min.js
• npm run watch:js - Watch JS files for changes and auto-build

Site Architecture

This is a Jekyll-based academic website built on the Minimal Mistakes theme, customized for academic portfolios.

Key Configuration

• Main config: _config.yml (site-wide settings, author info, collections)
• Dev config: _config.dev.yml (development overrides)
• Ruby dependencies: Gemfile
• Node dependencies: package.json

Content Structure

• _pages/ - Main site pages (about, CV, research, etc.)
• _posts/ - Blog posts
• _publications/ - Academic publications
• _talks/ - Conference talks and presentations
• _portfolio/ - Portfolio items
• files/ - Static files (PDFs, documents)
• images/ - Image assets

Theme Customization

• _sass/ - SCSS stylesheets for theme customization
• _includes/ - Reusable HTML components
• _layouts/ - Page templates
• assets/css/ - Additional CSS files
• assets/js/ - JavaScript files

Data and Automation

• _data/ - YAML data files (navigation, authors, comments)
• markdown_generator/ - Jupyter notebooks and Python scripts to generate markdown from TSV files
• Collections are defined in _config.yml with custom permalinks

GitHub Pages Deployment

Site is configured for GitHub Pages deployment with github-pages gem. Uses Jekyll plugins for sitemap, feed, and redirects.