runv.club docs
contents

Start here

Your corner of the internet

Writing

Photos

Make it yours

Together

Tools and services

Your account

Everything at once

pics

a photo gallery from ~/pics

in the terminal: 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.