The blog follows Jekyll’s standard directory structure with Minimal Mistakes theme conventions and GitHub Pages compatibility.
jonbeckett.github.io/
├── _config.yml # Jekyll configuration
├── _data/ # YAML data files
│ └── navigation.yml # Site navigation menu
├── _includes/ # Reusable template components
│ ├── breadcrumbs.html # Breadcrumb navigation
│ └── head/
│ └── custom.html # Custom head elements
├── _pages/ # Static pages
│ ├── about.md # About page
│ ├── categories.md # Categories archive
│ ├── disclaimer.md # Legal disclaimer
│ ├── posts.md # Posts archive
│ └── tags.md # Tags archive
├── _posts/ # Blog posts (organized by year)
│ ├── 2025/ # 2025 posts
│ └── 2026/ # 2026 posts
├── _site/ # Generated site (excluded from repo)
├── assets/ # Static assets
│ ├── css/
│ │ └── main.scss # Main stylesheet
│ └── images/ # Image assets
│ └── banners/ # Banner images
├── docs/ # Technical documentation
├── CNAME # Custom domain configuration
├── Gemfile # Ruby dependencies
├── index.html # Homepage template
└── README.md # Repository documentation
jonbeckett.com_posts/
├── 2025/ # Year-based organization
│ ├── 2025-01-05-linux-history-evolution.md
│ ├── 2025-05-01-note-taking.md
│ ├── 2025-06-01-getting-things-done.md
│ └── ...
└── 2026/ # Current year posts
├── 2026-01-02-flexible-bdd-solutions.md
├── 2026-01-03-ai-note-taking-revolution.md
└── ...
YYYY-MM-DD-post-title.md
_pages/
├── about.md # Author and site information
├── categories.md # Category taxonomy page
├── disclaimer.md # Legal disclaimer
├── posts.md # All posts archive
└── tags.md # Tag taxonomy page
_data/
└── navigation.yml # Site navigation configuration
Navigation Structure:
main:
- title: "About"
url: /about/
- title: "Posts"
url: /posts/
- title: "Categories"
url: /categories/
- title: "Tags"
url: /tags/
_includes/
├── breadcrumbs.html # Custom breadcrumb navigation
└── head/
└── custom.html # Custom HTML head elements
assets/
└── css/
└── main.scss # Main stylesheet entry point
SCSS Structure:
---
# Front matter required for Jekyll processing
---
@charset "utf-8";
@import "minimal-mistakes/skins/default";
@import "minimal-mistakes";
assets/
└── images/
├── banners/ # Banner images for posts
│ └── README.txt # Banner usage documentation
└── jonbeckett.jpg # Author profile image
docs/ # Comprehensive technical docs
├── README.md # Documentation index
├── technology-stack.md # Technologies overview
├── github-pages-hosting.md # Hosting configuration
├── jekyll-configuration.md # Jekyll setup details
├── file-structure.md # This file
└── ... # Additional documentation files
---
# Minimal front matter for Jekyll processing
# Required for .md files in _posts/ and _pages/
---
_site/
.sass-cache/
.jekyll-cache/
.jekyll-metadata
vendor/
node_modules/
.DS_Store
https://jonbeckett.com/
├── / # Homepage (index.html)
├── /about/ # About page (_pages/about.md)
├── /posts/ # Posts archive (_pages/posts.md)
├── /categories/ # Categories page (_pages/categories.md)
├── /tags/ # Tags page (_pages/tags.md)
├── /disclaimer/ # Disclaimer (_pages/disclaimer.md)
├── /YYYY/MM/DD/post-title/ # Individual posts
├── /categories/category-name/ # Category archives
└── /tags/tag-name/ # Tag archives
https://jonbeckett.com/assets/
├── /css/main.css # Compiled stylesheet
└── /images/ # Image assets
Directory Structure: Standard Jekyll with Minimal Mistakes theme
Content Organization: Year-based post organization
Asset Management: SCSS preprocessing with compression
Version Control: Git with appropriate .gitignore patterns