Gift Guide
Source content and build pipeline for "How To Get Your Stories In Front Of The Readers Who Need Them" — the lead-magnet PDF given away at reground.org/gift. Kept in its own repo because this content changes on its own schedule, independent of the reground-site deploys.
Styled to match reground.org's dark theme (background, heading, and CTA colors are pulled directly from that site's CSS).
One-time setup
You need pandoc and weasyprint on your PATH. Both are already used elsewhere on
this machine; nothing else to install.
Building a PDF
make template.pdf # the generic/base version
make partners/<slug>.pdf # a specific partnership's version
make # rebuilds template.pdf + every partners/*.md that exists
make clean # removes generated PDFs (never touches the .md sources)
make finds the source .md file automatically from the .pdf name you ask for, so
building any filled-in template is just naming the PDF you want.
Starting a new partnership
cp template.md partners/<slug>.md
Edit the new file's title (front matter) and rewrite the opening/closing copy to bridge your angle with the partner's audience — the 3 Step sections and their photos are generally reusable as-is. Then:
make partners/<slug>.pdf
Notes
- The 4 photos in
images/were extracted from the original PDF. They're intentionally generic/illustrative (not specific to any one partnership) and don't need to change per customization. template.htmlrenders the cover (title + byline + author photo) from the document's YAML front matter — you don't need to hand-write that part in the body of each.mdfile, just update the front matter.style.cssis the single source of truth for the visual theme. Edit it once andmake allrebuilds every partner PDF with the change.