CLAUDE.md

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

Project Overview

Personal blog and portfolio site for leocardz.com built with Jekyll 4.4.1, using the Minima theme with Bootstrap 5 for styling. Deployed via GitHub Pages.

Build Commands

# Install dependencies
bundle install

# Copy vendor assets (Bootstrap, jQuery, Popper.js) to _sass/vendor and assets/vendor
rake copy

# Local development server (http://localhost:4000)
bundle exec jekyll serve

# Build for production
bundle exec jekyll build

Architecture

Layout Hierarchy

compress.html          # HTML minification wrapper
  └── default.html     # Base HTML structure (head + skeleton)
        ├── page.html  # Static pages (about, contact, etc.)
        ├── post.html  # Blog post template with navigation
        ├── archive.html
        ├── projects.html
        └── timeline.html

Content Structure

_posts/ - Blog posts using YYYY-MM-DD-slug.markdown naming
_pages/ - Static pages (about, contact, projects, feeds, search)
_includes/html/ - Reusable components (head, sidebar, footer, SEO)
_header/ - Header assets
_drafts/ - Unpublished posts

Post Front Matter

---
layout: post
title: Post Title
date: 2024-01-01 12:00:00 +0100
permalink: /2024/01/01/slug
id: /2024/01/01/slug
excerpt: Brief description
categories: [article]
tags: [tag1, tag2]
sitemap: true
feed: true
featured: false
divider: false
author:
    name: Leonardo Cardoso
redirect_from:
    - /old-url
external_url: https://example.com  # Optional: for linked posts
github_url: https://github.com/...  # Optional: source link
gist_url: https://gist.github.com/... # Optional
---

Configuration

_config.yml defines:

Site metadata and social links
Sidebar navigation (supports external URLs and dividers)
Plugins: jekyll-sitemap, jekyll-redirect-from
Sass compilation settings
Timezone: Europe/Berlin

Vendor Assets

Managed via Rakefile tasks:

rake copy - Copies Bootstrap, jQuery, and Popper.js assets
rake clean - Removes vendor directories
Assets placed in _sass/vendor/ and assets/vendor/