Publishing to the gallery

Each album is keyed by a name (e.g. cityscapes) with three pieces: _data/galleries/<album>.yml, full images in gallery/archive/<album>/, and thumbnails in gallery/archive/<album>/thumbnails/.

Add photos to an existing album

Run these from the repository root.

1. Drop full-size photos into gallery/_inbox/.
2. Run: python3 publish_gallery.py <album> (e.g. python3 publish_gallery.py cityscapes)
3. The script generates thumbnails, pre-fills each date from EXIF, moves the originals into the album, and opens the album’s YAML in your editor.
4. Fill in captions for the new photos, save, and close the editor.
5. Commit and push.

Flags:

• --no-edit — skip the editor; new photos get blank captions to edit later.

Notes:

• A filename already present (in the YAML, the album folder, or thumbnails) is skipped and left in the inbox — nothing is overwritten.
• On every run the script reports entries whose image is missing on disk (including case mismatches like mono_lake.jpg vs mono_lake.JPG) or that lack a date, so you can clean up the data.
• GPS location metadata is stripped from each published JPEG (losslessly, via piexif) so photos don’t leak where they were taken. Copyright and other EXIF are preserved. piexif is optional: install it (pip install piexif) to enable stripping — without it, photos still publish but GPS is left in place (with a warning).

Review UI (pick album + caption per photo)

For a visual triage instead of the CLI:

1. Drop photos into gallery/_inbox/.
2. Run: python3 serve_gallery.py (opens a local page; --no-browser to print the URL only).
3. For each photo, pick an album, type a caption, adjust the date if needed, or tick skip.
4. Click Publish. Non-skipped photos move into their chosen album with a thumbnail and a YAML entry; skipped photos stay in the inbox.
5. Review git status / the diff, then commit and push.

The page warns if a filename already exists in the album you pick, and the date field is required (pre-filled from EXIF).

Create a new album

Still manual: add _data/galleries/<album>.yml (can be []), create gallery/archive/<album>/, add the album page and cover image, then publish as above.