blog-publish

1# blog-publish: static blog post pipeline
2 
3## Configuration
4 
5Set these once (`kit.toml`, `.env` or arguments).
6 
7| Setting | Meaning | Example |
8|---|---|---|
9| `BLOG_DIR` | Repo folder of your static blog | `./my-blog/` |
10| `POSTS_DIR` | Markdown posts, relative to `BLOG_DIR` | `content/posts/` |
11| `BUILD_CMD` | Command that builds the site | `python3 build.py` |
12| `SITE_DIR` | Build output folder | `site/` |
13| `BLOG_URL` | Public base URL | `https://blog.example.com` |
14| `POST_PATH` | URL pattern for a post | `/blog/<slug>/` |
15| `DEPLOY_CMD` | Your deploy command | see Deploy |
16| `SOCIAL_HANDLES` | Accounts used for distribution | per platform |
17 
18The steps below assume a build script that renders `POSTS_DIR/<slug>.md` into `SITE_DIR`. Adjust names to your generator (Hugo, Eleventy, Astro, a custom script).
19 
20## Content checklist (every post)
21 
221. **Front matter** with `title, subtitle, slug, date, description, tags, author, published`. Match existing posts. If the subtitle renders under the H1, keep it to one sentence stating what the post is about.
232. **TL;DR is optional.** Narrative, build and essay posts open problem-first with no summary box (see Narrative arc). Reserve a TL;DR for reference-style or scannable how-to posts, and then use a one or two sentence hook plus bullets, never one long paragraph.
24…