From 5ce37bd5150f23923afc283ad6449be8915bf928 Mon Sep 17 00:00:00 2001 From: erdgeist Date: Wed, 22 Jul 2026 15:50:17 +0200 Subject: Explain the rest of how PDFs are used as headlines --- doc/DESIGN_HISTORY.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/doc/DESIGN_HISTORY.md b/doc/DESIGN_HISTORY.md index 801652b..534be44 100644 --- a/doc/DESIGN_HISTORY.md +++ b/doc/DESIGN_HISTORY.md @@ -213,10 +213,16 @@ and the subsystems below treat both through one mechanism. Every attachment is an Asset joined to pages via RelatedAsset. The starred attachment ("headline") becomes the page's face on the public site; if none is starred, visitors get a link to browse all -attached images instead. PDFs are headline-eligible because the -standard raster variant set is generated for them from the -document's first page (ImageMagick with Ghostscript), so aggregators -and teasers need no special case. +attached images instead. + +PDFs are headline-eligible because the standard variant set (thumb, +medium, large, headline) is generated for them as PNG rasters of the +document's first page (ImageMagick with Ghostscript); the original +remains the PDF. Variant directories of older PDF assets may still +contain a .pdf beside the .png — residue of the Paperclip era, when +variants kept the original's extension. These files are unreferenced +and safe to delete; until someone does, the mix is expected, not a +bug. Presentation differs by type at the last step only: an image headline opens in the lightbox, a PDF headline renders as a document -- cgit v1.3