diff options
| author | Paul Buetow <paul@buetow.org> | 2026-06-22 10:15:42 +0300 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-06-22 10:15:42 +0300 |
| commit | b84647c749dabdc011f62d8e8213743fd03f565b (patch) | |
| tree | 05c076cd2033ef99ce0f0f8b058ef0736b8642ec /docs/usage.md | |
| parent | 6945a0ae9afb18313636c09f34959ee5b225f78d (diff) | |
Add large 2x2 feature tiles and a CSS-grid overview
Allow a single photo to be blown up into a large "feature" tile that
spans a 2x2 block of the album overview, controlled by a new
THUMB_FEATURE_PERCENT (0-100, default 10; 0 disables). Each tile rolls
for a feature first, then for a subdivision, otherwise stays a normal
square.
To pack mixed-size tiles (normal 1x1, subdivided 1x1, feature 2x2)
without gaps, the overview is now a real CSS grid with
grid-auto-flow: dense, so smaller tiles backfill the holes a 2x2 feature
would leave. Tile spacing moved from per-image padding to the grid gap.
Feature tiles reuse the img.thumb class and its dramatic hover.
THUMB_FEATURE_PERCENT is wired through the same layers as
THUMB_SUBDIVIDE_PERCENT: config defaults, 0..100 validation,
--print-config, the --feature 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.
Setting both percentages to 0 reproduces the previous all-1x1 grid.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'docs/usage.md')
| -rw-r--r-- | docs/usage.md | 1 |
1 files changed, 1 insertions, 0 deletions
diff --git a/docs/usage.md b/docs/usage.md index f4c8d27..3f85471 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -69,6 +69,7 @@ config variable documented in [configuration.md](configuration.md). | `--thumbheight VALUE` | `THUMBHEIGHT` | | `--maxpreviews N` | `MAXPREVIEWS` | | `--subdivide PERCENT` | `THUMB_SUBDIVIDE_PERCENT` | +| `--feature PERCENT` | `THUMB_FEATURE_PERCENT` | | `--image-jobs N` | `IMAGE_JOBS` | | `--random-seed VALUE` | `RANDOM_SEED` | | `--shuffle` | `SHUFFLE=yes` | |