From 6c8e1832eee806733d97db3d7fdba2a0e9aa6742 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Mon, 15 Jun 2026 14:37:45 +0300 Subject: Add README.md describing the photosite and shuriken.sh --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9a8da2c --- /dev/null +++ b/README.md @@ -0,0 +1,45 @@ +# irregular.ninja + +Photo site generation for **irregular.ninja** and **alt.irregular.ninja**. + +This repository contains the working directories and build automation for generating static photo albums using [`shuriken.sh`](https://codeberg.org/snonux/shuriken.sh), a lightweight shell-based photo album generator. + +## Structure + +- `irregular.ninja/` — Main photo album + - `shuriken.conf` — Album configuration (title, geometry, templates) + - `incoming/` — Symlink to the source photo directory + - `incoming-invalid/` — Placeholder for rejected/invalid photos + - `Justfile` — Build recipes for this album + +- `alt.irregular.ninja/` — Alternative photo album + - `shuriken.conf` — Album configuration + - `incoming/` — Symlink to the source photo directory + - `Justfile` — Build recipes for this album + +- `Justfile` — Top-level build file that delegates to both sub-albums + +## Building + +Generate a single album: + +```bash +just irregular.ninja/generate +just alt.irregular.ninja/generate +``` + +Generate both albums: + +```bash +just all +``` + +Dry-run to preview changes without writing: + +```bash +just dry-run-all +``` + +## Tool + +Album generation is powered by [`shuriken.sh`](https://codeberg.org/snonux/shuriken.sh). -- cgit v1.2.3