Merge branch 'main' into feature/sponsor-page

Author: mrbiggred

.gitattributes

@@ -0,0 +1,6 @@
+# Ensure consistent line endings
+* text=auto
+
+# Scripts must use LF
+*.py text eol=lf
+*.sh text eol=lf

.python-version

@@ -0,0 +1 @@
+3.14

AGENTS.md

@@ -7,7 +7,7 @@ Weekly Dev Chat website — MkDocs Material static site. Read `mkdocs.yml` and r
 - Posts are for Tuesdays (the weekly chat day). Use next Tuesday's date unless told otherwise.
 - End post body with this paragraph (before the image):
   `Everyone and anyone is welcome to [join](https://weeklydevchat.com/join/) as long as you are kind, supportive, and respectful of others. Zoom link will be posted at 12pm MDT.`
-- Place images in the same directory as the post's `index.md`.
+- Place images in the same directory as the post's `index.md`. Run `python3 scripts/optimize_image.py <image>` to convert to WebP and resize for the web.
 - Use `./create_post.sh` to scaffold a new post (calculates next Tuesday automatically).
 - **Multiple posts on the same date:** If a date folder already has an `index.md`, prefix the filename with a number and dash (e.g., `0-index.md`). The newest/latest post should use the lowest number so it appears first on the homepage. The original `index.md` keeps its name.
 

README.md

@@ -118,6 +118,43 @@ These scripts will:
 
 4. Add any images to the same directory as the post
 
+5. **Optimize images** for the web before committing (see [Optimizing Images](#optimizing-images) below)
+
+### Optimizing Images
+
+After adding an image to a post, run the optimization script to convert it to WebP and resize it for the web:
+
+```bash
+python3 scripts/optimize_image.py docs/posts/YYYY/MM/DD/your_image.png
+```
+
+This will create an optimized `.webp` file alongside the original. Update your post's markdown to reference the new `.webp` file, then delete the original if no longer needed.
+
+**Options:**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--quality` | 80 | WebP quality (1–100) |
+| `--max-width` | 1200 | Max width in pixels (won't upscale) |
+
+**Examples:**
+
+```bash
+# Optimize a single image with defaults
+python3 scripts/optimize_image.py docs/posts/2026/04/14/photo.png
+
+# Batch optimize multiple images
+python3 scripts/optimize_image.py docs/posts/2026/04/14/*.png docs/posts/2026/04/14/*.jpg
+
+# Custom quality and max width
+python3 scripts/optimize_image.py --quality 90 --max-width 1600 image.jpeg
+```
+
+> **Note:** This script requires [Pillow](https://pillow.readthedocs.io/). Install dev dependencies with:
+> ```bash
+> pip install -r requirements-dev.txt
+> ```
+
 ### Categories and Tags
 
 Categories are broad topic groupings and tags are specific topic labels for filtering. **Please use existing categories and tags when possible** to keep the taxonomy consistent. New ones can be added when truly needed.
@@ -149,8 +186,12 @@ Sponsor and donor entries live in [`data/sponsors.yml`](data/sponsors.yml), whic
 ├── docker-compose.yml         # Docker development environment
 ├── create_post.sh             # Bash script to create blog posts
 ├── create_post.ps1            # PowerShell script to create blog posts
+├── requirements-dev.in         # Dev-only dependency pins (e.g. Pillow)
+├── requirements-dev.txt        # Compiled dev dependencies
 ├── scripts/
-│   └── find_tags_categories.py # List all existing tags and categories
+│   |── find_tags_categories.py # List all existing tags and categories
+│   |── find_tags_categories.py # List all existing tags and categories
+│   └── optimize_image.py       # Optimize images for the web (PNG/JPEG → WebP)
 ├── data/
 │   └── sponsors.yml           # Sponsor & donor data (consumed by macros plugin)
 ├── .github/
@@ -183,6 +224,9 @@ mkdocs serve -a 0.0.0.0:8000   # Start server accessible on network
 mkdocs build                    # Build static site to site/ directory
 mkdocs build --clean            # Clean build
 
+# Optimize an image for the web
+python3 scripts/optimize_image.py docs/posts/YYYY/MM/DD/image.png
+
 # Help
 mkdocs -h                       # Show help
 

docs/.authors.yml

@@ -2,12 +2,12 @@ authors:
   chris:
     name: Chris Cumming
     description: Host
-    avatar: https://weeklydevchat.com/hosts/chris.jpeg
+    avatar: /hosts/chris.webp
   norm:
     name: Norman Lorrain
     description: Host
-    avatar: https://weeklydevchat.com/hosts/norm.png
+    avatar: /hosts/norm.webp
   omar:
     name: Omar Ashour
     description: Host
-    avatar: https://weeklydevchat.com/hosts/omar.png
+    avatar: /hosts/omar.webp