help pics

Put photos in ~/pics and they become a gallery at
https://runv.club/~you/pics/, and you show up on https://runv.club/pics/

  pics          put it up now
  pics clean    take the gallery down until you type pics again
                (~/pics stays as it is)

The server also picks up changes on its own within a few minutes. From
your own computer:

  scp *.jpg runv.club:pics/

JPEG, PNG and WebP, up to 40 MB each and 1000 photos. iPhone HEIC
photos need converting first (most phones can share as JPEG).

What goes up is a new copy made from the picture alone: turned the
right way, at most 2000 pixels on the long side, and without anything
else from the original file. No GPS location, no camera, no time of
day. The originals in ~/pics are left alone and kept private to you.
Both count toward your disk quota.

Captions go in ~/pics/captions.txt, one per line, file name first:

  lighthouse.jpg   the lighthouse at Farol, before the rain

To change how it looks, write ~/pics/style.css (up to 64 KB). It goes
up with the gallery and comes after the default style, so whatever you
set wins. The pieces you can style:

  body, h1, a             the page itself
  .grid                   the index, one link per photo
  .grid img, .grid span   the thumbnails and their captions
  figure, figcaption      a photo on its own page
  .when                   the date under it
  nav                     the newer/older links
  footer                  the links at the bottom

Delete style.css and it goes back to the default.

Want more than that? `pics template` copies the page itself to
~/pics/template.html, and then the whole page is yours: header, layout,
scripts, a slideshow if you like. It's a jinja2 template:

  kind            "index" for the gallery, "photo" for a photo's own page
  title           the page title
  photo           on a photo page: photo.image, photo.thumb, photo.width,
                  photo.height, photo.caption, photo.alt, photo.date,
                  photo.url
  newer, older    the photos next to this one, or nothing
  photos          every photo, newest first, each like photo above
  user, gallery_url, home_url
  style           the link to your style.css, if you have one
  default_css     our CSS, to keep or to leave out

  {% for p in photos %}<img src="{{ p.thumb }}" alt="{{ p.alt }}">{% endfor %}

If the template breaks, the pages stay as they were and the reason goes
in ~/pics/template.err. Delete template.html to go back to ours.

Delete a photo from ~/pics and it comes down from the gallery too.
Only post photos you took or may share, and ask before posting people
who aren't in on it.