Scott Mather

CLAUDE.md

CLAUDE.md

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

What this is

Jekyll static portfolio site for mather.cv. Uses the github-pages gem for its Jekyll version, but is NOT hosted on GitHub Pages — pushing to main triggers .github/workflows/deploy.yml, which builds the site and rsyncs _site/ to a VPS (ubuntu@mather.cv:/var/www/mather.cv/html/). Every push to main is a production deploy.

Commands

bundle install               # install dependencies
bundle exec jekyll serve     # local dev server at http://localhost:4000 with auto-rebuild
bundle exec jekyll build     # production build to _site/

No tests or linters.

Architecture

  • _work/ collection — one markdown file per portfolio piece, rendered at /work/:name/ with the work layout (set via defaults in _config.yml, no layout needed in front matter). Front matter drives everything: order controls homepage sort, hidden: true excludes an item from the homepage grid, plus title, external_url, thumb, screenshot, tags, summary. The markdown body becomes the detail page content.
  • _data/projects.yml — drives the “Projects” (GitHub repos) section on the homepage. Currently placeholder content.
  • Layouts — default.html is the shell (header/footer includes); home.html, work.html, and page.html all nest inside it. The homepage content lives in _layouts/home.html itself, not index.md.
  • Assets — single stylesheet (assets/css/site.css) and script (assets/js/site.js); no build step for either. Screenshots in assets/screenshots/ have both .png and .svg variants; the .png is what _work front matter references.