summaryrefslogtreecommitdiff
path: root/AGENTS.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-06-22 09:52:57 +0300
committerPaul Buetow <paul@buetow.org>2026-06-22 09:52:57 +0300
commit6945a0ae9afb18313636c09f34959ee5b225f78d (patch)
treee74aa7b861543f5407de863f9667b4ccc994bbbd /AGENTS.md
parent79d78a296d2919155fe4d4bb2fac73d2fa7adeec (diff)
Add dynamic subdivided thumbnail tiles
Make the album preview grid livelier: with a configurable probability (THUMB_SUBDIVIDE_PERCENT, default 30%) a square thumbnail tile is subdivided into several smaller thumbnails packed into the same square footprint, chosen at random from: - quad: 2x2 squares (4 photos) - two-wide: two stacked full-width strips (2 photos) - squares+wide: two squares plus one full-width strip, strip on the top or the bottom (3 photos) Each sub-thumbnail stays its own clickable photo with its own view page; subdivision only groups consecutive photos visually, so preview numbering and the view/details/redirect pages are unchanged. No new images are generated (CSS object-fit crops the existing aspect-correct thumbs into squares or wide strips). Sub-thumbnails get the same random entry animation and the same dramatic hover (flip/scale/rotate/filter) as full thumbs. The layout choice reuses the seeded random_index, so builds stay reproducible under RANDOM_SEED. THUMB_SUBDIVIDE_PERCENT=0 reproduces the previous output byte-for-byte. The new option is wired through the config defaults, validation (0..100), --print-config, the --subdivide CLI flag, the usage text, and the shuriken.json / --dry-run metadata, with docs and tests updated. Generated HTML and CSS pass the W3C Nu HTML checker and CSS validator. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 0bc5a71..f827492 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -13,3 +13,22 @@ Expected checks for Bash changes:
- `just shellcheck`
- `just check-generated`
- `git diff --check`
+
+## Manual visual testing
+
+To eyeball generated output (thumbnail grid, tile subdivision, splash, stats),
+regenerate the real `irregular.ninja` album with the freshly built binary and
+template, then open it in Firefox:
+
+```sh
+just build
+cd ~/git/irregular.ninja/irregular.ninja
+/path/to/shuriken.sh/bin/shuriken --generate \
+ --template /path/to/shuriken.sh/share/templates/default
+firefox "file://$PWD/dist/index.html"
+```
+
+Use the in-tree `bin/shuriken` and `share/templates/default` (not the installed
+copies) so local changes are exercised. Existing thumbnails/blurs are reused, so
+only the HTML is re-rendered. This regenerates locally only — do **not** run
+`shuriken --sync` / `just sync`, which would publish to the live web servers.