CLAUDE.md
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
What this is
A personal academic portfolio website for Bumho Son (Assistant Professor, Chung-Ang University) built on the Academic Pages Jekyll template, deployed via GitHub Pages.
Running locally
# Install Ruby dependencies (first time only)
bundle install
# Serve with live reload
bundle exec jekyll serve -l -H localhost
# Site available at http://localhost:4000
Docker alternative:
chmod -R 777 .
docker compose up
# Site available at http://localhost:4000
Changes to _config.yml require restarting the server; Markdown/HTML changes rebuild automatically.
Architecture
Content collections (_config.yml declares these)
| Directory | URL prefix | Purpose |
|---|---|---|
_publications/ | /publications/ | Journal articles and conference papers |
_teaching/ | /teaching/ | Courses taught |
_projects/ | /projects/ | Research/consulting projects |
_portfolio/ | /portfolio/ | Portfolio items |
_posts/ | /:categories/:title/ | Blog posts |
Each collection item is a Markdown file with YAML front matter. Pages in _pages/ aggregate these collections using Liquid templating.
Key configuration
_config.yml— site-wide settings: author bio, social links, publication categories, Jekyll plugins. Thepublication_categorymapping (manuscripts,conferences,books) controls how publications are grouped on the publications page._data/cv.json— structured CV data consumed by the JSON CV page (/cv-json/). Generated byscripts/update_cv_json.sh._data/navigation.yml— top navigation links.
Publication front matter fields
---
title: "Paper title"
collection: publications
category: manuscripts # or: conferences, books
date: 2024-01-01
venue: 'Journal Name'
paperurl: 'https://...'
authors: 'Author One, Author Two, ...'
---
Project front matter fields
---
title: "Project title"
collection: projects
importance: A # A/B/C controls display order on /projects/
date: 2024-01-01
---
Scripts and automation
CV JSON update
bash scripts/update_cv_json.sh
Parses _pages/cv.md and all collection directories, writes to _data/cv.json. Run after editing the CV.
Markdown generator (publications/talks from TSV)
cd markdown_generator
python publications.py # reads publications.tsv, writes to ../_publications/
python talks.py # reads talks.tsv, writes to ../_talks/ (if present)
Talkmap
talkmap.ipynb geocodes talk locations and generates talkmap/org-locations.js. A GitHub Actions workflow (.github/workflows/scrape_talks.yml) runs it automatically when _talks/ or talkmap.ipynb changes.
Deployment
Pushing to master triggers GitHub Pages build and deployment automatically. No manual build step needed.
