CLAUDE.md

CLAUDE.md

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

Local Development

bundle install              # install dependencies (delete Gemfile.lock first if errors)
bundle exec jekyll liveserve --config _config.yml,_config.dev.yml  # serve at localhost:4000 with live reload
bundle exec jekyll serve    # serve without live reload
bundle clean                # clean build artifacts

_config.dev.yml overrides the production URL and disables analytics for local development.

Site Architecture

This is a Jekyll academic personal website based on the academicpages theme (forked from Minimal Mistakes).

Content lives in:

  • _pages/ — static pages (about/home, publications, teaching, etc.)
  • _posts/ — blog posts (YYYY-MM-DD-slug.md format)
  • _publications/ — one file per publication (YYYY-MM-DD-slug.md format)
  • files/ — downloadable PDFs
  • images/ — site images, including per-post subdirectories under images/blog/

Key configuration:

  • _config.yml — site-wide settings (title, URL, author profile, social links)
  • _data/navigation.yml — top nav links (most are currently commented out)
  • _data/authors.yml — author metadata used in the sidebar

Publication front matter uses collection: publications, permalink, venue, paperurl, and an optional lead: True flag to mark first-author papers.

Deployment is via GitHub Pages — pushing to master triggers an automatic build and deploy to clementwong.github.io.