Skip to content

Photos

Film photo gallery: a static site built with Hugo and hugo-theme-gallery, served from a Cloudflare Worker at snap.newling.cloud. It gives film work a shareable home that doesn't depend on a social platform.

Live since 2026-11-04

First published with the desktop shortcut. See roadmap 6I for remaining checks.

Why it isn't on proxfold

There is no CT, VM, Ansible role, Dockhand stack or Caddy route. A static site has no database or public login to maintain, viewers don't load the home uplink, and the stash pool (95% on 2026-11-04) stays out of it. The output is plain files, so it can move to another static host or to Caddy file_server if needed; Caddy would need a role change and more disk on CT 107.

Service details

Property Value
Site name "picture things", deliberately lower case
Copyright notice copyright in hugo.toml, shown in the footer. Follows Arts Law guidance (optional, © plus owner name)
Source git.rampancy.cloud/rampancy/photos (private)
Local clone ~/photos on WSL
GitHub mirror rampantlemming/photos (private), via Forgejo push mirror with a single-repo fine-grained PAT (sync_on_commit, 1h fallback)
Generator Hugo Extended 0.169.0 (~/.local/bin/hugo), theme as a git submodule pinned to 748df10
Deploy tooling wrangler 4.157.0 (repo devDependency) on Node 22.23.4 (~/.local/opt, used only by scripts/deploy.sh; the default Node stays at apt 18)
Hosting Assets-only Worker with a Custom Domain on snap.newling.cloud; workers.dev and preview URLs disabled
Domain newling.cloud (Porkbun, expires 2027-02-15; Cloudflare DNS). It also carries Google mail records, so leave its MX and SPF records alone

Repo layout

Path Purpose
scans/ Full-resolution archive by roll. Never published; Hugo ignores it
content/<album>/ The curated site: images copied from scans/, an order.txt setting their order, and a generated index.md
layouts/partials/gallery.html Theme override raising the lightbox image from 1600px to 2400px. Recheck when updating the theme
assets/css/custom.css Site styling; currently the all-lower-case look, which is display-only
scripts/ publish.sh (the full routine), plus sync-order.py, build.sh, deploy.sh, to-srgb.sh, rotate.sh, contact-sheets.sh
scripts/windows/ Source for the Publish Photos and Photo Albums desktop shortcuts
contact-sheets/ Per-roll sheets for choosing photos. Gitignored; regenerate with the script

Storage and backup

Copy Location Status
Working copy WSL ~/photos Verified 2026-11-04
Source of truth Forgejo on CT 109 (about 2.1G; 5.4G free after the push) Verified 2026-11-04
On-site backup QNAP via pbs-daily Expected from the 02:00 job covering CT 109; not yet verified
Off-site GitHub private repo Push mirror from Forgejo, added 2026-11-04
Off-site Google Drive Holds the original collection

The repo holds 291 scans (about 2.0 GiB). The 25 sideways 6056-* Ghostcon originals were deliberately left out in favour of their upright copies; they remain in Google Drive.

GitHub rejects pushes over 2 GB

Push large scan additions in batches, because the mirror forwards each push to GitHub. The initial import was split into two commits (0.87 GiB and 1.12 GiB) and pushed to GitHub directly before the mirror was added.

Image settings

Tested against real scans on 2026-11-04.

Setting Value Why
publishResources false, site-wide via cascade Required: 36 scans exceed Cloudflare's 25 MiB per-file limit. Also removes the Download button and publishes only metadata-free resizes
Lightbox size 2400px long edge The theme's 1600px is low for film. Hugo doesn't upscale, so 1818px scans stay at 1818px
JPEG quality 88 Hugo's default is 75. The largest 2400px test output was 1.28 MiB

Publishing

See the Photo Publishing runbook. In short: copy picks from scans/ into content/<album>/, double-click Publish Photos on the Windows desktop, check the preview, and type yes.

Gotchas

  • Hugo drops ICC profiles. The October 2025 B&W roll is mostly tagged Dot Gain 20%; unconverted, its midtones rendered about 20/255 darker than a colour-managed view. Converting with to-srgb.sh reduced the RMS error from 17.14 to 0.35, and publish.sh now does this automatically for new photos.
  • Hugo keeps the source format. Browsers can't display TIFF and PNG scans are large, so publish.sh converts new ones to JPEG.
  • Hugo is pinned at 0.169.0. The theme uses features deprecated in Hugo (libsass, Image.Exif), so test before upgrading.
  • Some scans are sideways with no EXIF tag. Hugo only honours the tag, so these need physically rotating. 846839150012 is one; rotate.sh re-encodes at quality 95, which grew one test file from 4.9 to 6.8 MiB.
  • Don't add the usual per-vhost CNAME. Unlike Komga, this site doesn't go through Caddy. Cloudflare creates the DNS record and certificate for a Custom Domain, and refuses a hostname with an existing CNAME.
  • Don't reuse the Caddy token for deploys. It only has Zone:Read + DNS:Edit. Deploys need a separate "Edit Cloudflare Workers" token.
  • Avoid WebP sources. The theme warns that Hugo's WebP handling produces dull images on resize.