# Quiet's Blog

A personal blog built with Markdown content and a Python build script that generates static HTML.

## Writing Posts

Create a `.md` file with YAML frontmatter in the appropriate `content/` subdirectory:

```markdown
---
title: "My Post Title"
date: 2026-02-15
description: "A short summary of the post"
---

Post content in Markdown here...
```

### Post Categories

| Category | Directory | Filename Convention | Example |
|----------|-----------|-------------------|---------|
| Regular | `content/posts/` | Any slug | `content/posts/my-topic.md` |
| Daily | `content/daily/` | `YYYY-MM-DD.md` | `content/daily/2026-02-15.md` |
| Weekly | `content/weekly/` | `YYYY-WNN.md` | `content/weekly/2026-W07.md` |

## Building

Requires [uv](https://docs.astral.sh/uv/):

```sh
uv run build.py
```

Output goes to `dist/`. Serve it with any static file server:

```sh
python3 -m http.server -d dist
```

## Project Structure

```
content/          # Markdown source files
  posts/          # Regular posts
  daily/          # Daily posts
  weekly/         # Weekly posts
  about.md        # About page
templates/        # HTML templates with {{placeholder}} variables
static/           # Static assets (CSS)
build.py          # Build script (dependencies declared inline via PEP 723)
dist/             # Generated output (gitignored)
```