summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2026-06-22Add large 2x2 feature tiles and a CSS-grid overviewPaul Buetow
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>
2026-06-22Add dynamic subdivided thumbnail tilesPaul Buetow
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>
2026-06-21Add Docker image supportPaul Buetow
2026-06-19docs: polish readability of quick-start and reference pagesPaul Buetow
- Friendlier, less jargon-heavy quick-start comments in README. - Simplify the --config row in the README main-flags table. - Replace &lt;...&gt; HTML entities with backtick code spans in generation.md and templates.md. - Rephrase the supported-images note in configuration.md to drop the find-specific 'maxdepth 1' phrasing in favour of plain English.
2026-06-19docs: split README into quick-start + reference pages under docs/Paul Buetow
Trim README.md to a quick-start guide (install, init, generate, sync, clean) with a main-flags table and feature-toggle summary, and move the detailed reference material into focused pages under docs/: installation, usage, configuration, generation, publishing, templates. Correctness fixes carried over during the split: - The 'Site generated ... with <URL>' source link lives in the page header bar (header.tmpl), not the footer (footer.tmpl only renders the tarball download). Fixed in docs and the SOURCE_URL code comment. - --sync is a config-backed action and accepts --config PATH / reads ./shuriken.conf; the --config action list now includes it. - --refresh-splash also re-copies the site favicon; documented. - State the Bash 5.1 requirement (enforced by the script) in the docs. - docs/stats-exif-audit.md: the EXIF cache moved to metadata-cache.source.sh and the native-field parser extension was implemented; add a status note and fix the stale module path. bin/shuriken regenerated from the config.source.sh comment change.
2026-06-15Persist the EXIF cache in a volatile ./cache dir parallel to ./distPaul Buetow
The per-photo `identify -verbose` cache lived in $DIST_DIR/.shuriken-cache, which is inside the throwaway staging dir and the published dist: a fresh/cleared dist lost it (forcing a full, slow re-identify of every original) and it got deployed to web servers. Move it to a volatile ./cache/exif directory parallel to ./dist (dirname of DIST_DIR resolves to the working dir in both the staging and direct contexts). Now an unchanged photo skips identify on every regenerate, the cache survives a cleared dist, and it is never deployed. --force clears ./cache/exif once up front (clear_exif_cache) and the run repopulates it, so force still does exactly one identify per photo. Dropped .shuriken-cache from the staging-copy loop. Tests and the audit doc updated for the new cache location. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14nm0 audit EXIF field coverage for stats featurePaul Buetow
Add docs/stats-exif-audit.md classifying each planned stats category as viable/conditional/not viable, grounded in what magick identify -verbose actually exposes and what shuriken's exif:-only parser can reach. Records required normalization work (rationals, DateTimeOriginal, enum/bitmask decoding, native Geometry/Format parsing) and the recommended v1 stat set. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2022-02-20ShellCheck OK now. Also, some refactorings.Paul Buetow
2022-02-05use default by defaultPaul Buetow
2021-05-01fix URIsPaul Buetow
2021-01-24prepare next release0.4.5Paul Buetow
2015-04-12Introducing the recursive: argument. Can also specify FIND_ARGS. Can also ↵Paul Buetow (scorpion)
specify ORIGINAL_BASEPATH.
2014-06-22New releasePaul C. Buetow (mars.fritz.box)
2014-06-14New releasePaul C. Buetow (mars.fritz.box)
2014-06-14New releasePaul C. Buetow (mars.fritz.box)
2014-05-13New release0.4.2Paul C. Buetow (mars.fritz.box)
2014-05-13New release0.4.1Paul C. Buetow (mars.fritz.box)
2014-05-09refactorPaul C. Buetow (mars.fritz.box)
2014-05-09refactorPaul C. Buetow (mars.fritz.box)
2014-05-09refactorPaul C. Buetow (mars.fritz.box)
2014-05-09refactorPaul C. Buetow (mars.fritz.box)
2014-05-07add makemakePaul C. Buetow (mars.fritz.box)
2014-02-16New releasePaul Buetow (mars.fritz.box)
2014-02-16add optional custom rcfile pathPaul Buetow (mars.fritz.box)
2014-01-11New releasePaul Buetow (mars.fritz.box)
2014-01-11New releasePaul Buetow (mars.fritz.box)
2014-01-03New release0.2.20.2.1Paul Buetow (mars.fritz.box)
2013-12-29and practically it works tooPaul Buetow (mars.fritz.box)
2013-12-29New releasePaul Buetow (mars.fritz.box)
2013-12-29New releasePaul Buetow (mars.fritz.box)
2013-12-29New releasePaul Buetow (mars.fritz.box)
2013-12-29What happened last night can happen again.Paul Buetow (mars.fritz.box)
2013-12-29Q: How many Harvard MBA's does it take to screw in a light bulb?Paul Buetow (mars.fritz.box)
A: Just one. He grasps it firmly and the universe revolves around him.
2013-12-29update documentationPaul Buetow (mars.fritz.box)
2013-12-29i can use the package nowPaul Buetow (mars.fritz.box)
2013-12-27some version which does not work yetPaul Buetow (mars.fritz.box)
2013-12-27add manpagesPaul Buetow (mars.fritz.box)
2013-12-27initial debian package versionPaul Buetow (mars.fritz.box)