summaryrefslogtreecommitdiff
path: root/README.md
blob: 8854eaefeff16c5f087337bdd3b9ffa81f9aa268 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# irregular.ninja

Photo site generation for [**irregular.ninja**](https://irregular.ninja) and [**alt.irregular.ninja**](https://alt.irregular.ninja) (the latter URL brings you to a site with the 2nd-order photos, which I don't like quite as much as the photos on the "main" page).

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 ([https://irregular.ninja](https://irregular.ninja))
  - `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 ([https://alt.irregular.ninja](https://alt.irregular.ninja))
  - `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).