CLAUDE.md

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

Overview

Personal academic website for Carole Marullaz (PhD student, University of Zurich). Built with Jekyll using the Minimal Mistakes remote theme (mmistakes/minimal-mistakes), hosted on GitHub Pages.

Development Commands

# Install dependencies
bundle install

# Serve locally (auto-rebuilds on file changes, but NOT on _config.yml changes)
bundle exec jekyll serve

# Build without serving
bundle exec jekyll build

After changing _config.yml, you must restart the server.

Architecture

• Theme: Minimal Mistakes, loaded via jekyll-remote-theme (not vendored). Only files that override the theme’s defaults are in this repo.
• _config.yml: Site-wide settings — author info, plugins, navigation, defaults. The skin is "default".
• index.html: Homepage content (HTML embedded in front matter layout single).
• _pages/: Site pages (Research, Teaching, 404) written in Markdown with inline HTML for links (target="_blank").
• _data/navigation.yml: Top navigation bar entries (Research, Teaching, CV pdf link).
• _data/ui-text.yml: UI strings for visitor-facing text (error messages, comments, etc.).
• _includes/: Overrides for theme partials — author-profile.html, footer.html, masthead.html, head.html, head/custom.html.
• _layouts/: default.html and single.html override the theme layouts.
• assets/: Images (bio-photo.jpg), PDF files (CV.pdf), and custom CSS (assets/css/custom.css).
• assets/css/custom.css: Style overrides on top of Minimal Mistakes defaults. Linked via custom_css in _config.yml.

Key Conventions

• Pages use layout: single with author_profile: false (set in _config.yml defaults).
• The homepage uses layout: single with author_profile: true.
• External links in page content use raw HTML <a> tags with target="_blank".
• The CV link in the navigation bar points directly to /assets/CV.pdf (marked external: true).