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)

DirectoryURL prefixPurpose
_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. The publication_category mapping (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 by scripts/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.