What problem does it solve?
Publishing a signed draft into the correct blog repo location without breaking YAML/JSON-LD formatting, forgetting required transforms, or writing manual git commands.
Core Features & Use Cases
- Quote-safe publishing transform: Applies the repo’s vendored smart-quote transform (scripts/smart_quotes.py) while preserving YAML frontmatter and JSON-LD blocks.
- Correct blog status + metadata: Forces status to
published, bumps dateModified to today (including JSON-LD dateModified), and rewrites hero/image references to repo paths.
- Deterministic file deployment: Copies the staged draft from drafts/<slug>.md into the publishing repo’s post and hero locations, optionally including referenced media and social derivative files.
- Writer-proof workflow: Prepares a local commit on the default branch but does not push; you deploy via GitHub Desktop’s “Push origin” one-click flow.
Quick Start
Run /4d-blog-engine:blog-publish <slug> to prepare a commit that ships your Phase-4-signed draft to your live blog on the next push.