CLAUDE.md

CLAUDE.md

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

Overview

This is a personal blog (scottjbaldwin.github.io) built with Jekyll using the “Daktilo” theme — a minimal typewriter-inspired design. It is hosted on GitHub Pages.

Development Commands

# Serve locally with live reload
jekyll serve --watch

# Build the site
jekyll build

The site is available at http://127.0.0.1:4000 when running locally.

Adding Content

New Blog Posts

Create a file in _posts/ with the naming convention YYYY-MM-DD-post-title.md (or .markdown). Front matter format:

---
layout: post
title: "Post Title"
subtitle: "Optional subtitle"
date:   YYYY-MM-DD HH:MM:SS
categories: [aws, serverless, dotnet]
---

Categories must match slugs defined in _data/categories.yml.

Adding a New Category

1. Add an entry to _data/categories.yml: ```yaml
   • slug: my-category name: My Category ```
2. Create categories/my-category.html:

   ---
   layout: category
   category: my-category
   permalink: /categories/my-category/
   ---
   

The new category will then appear in the footer’s “Explore” section.

Site Architecture

• _config.yml — site-wide settings (title, author, analytics, markdown engine)
• _layouts/ — page templates (post.html, page.html, category.html, default.html)
• _includes/ — reusable partials (header, meta tags, post/page/externals sub-dirs)
• _sass/ — stylesheet source
• _data/categories.yml — category definitions used by the footer navigation
• categories/ — one HTML file per category (required for category pages to work)
• assets/ — images, fonts, and other static files
• _posts/ — blog posts in Markdown

The site uses kramdown as the Markdown processor and highlight.js for syntax highlighting (configured via highlightstyle in _config.yml).

Dev Container

A devcontainer is configured (.devcontainer/devcontainer.json) using the official Jekyll image with neovim, PowerShell (with posh-git), and Claude Code pre-installed.