99 lines
3.3 KiB
Markdown
99 lines
3.3 KiB
Markdown
# Gallery
|
|
|
|
Static photo gallery for logging meals and food memories.
|
|
|
|
The site is based on the HTML5 UP Lens template and currently ships as a plain static site: HTML, CSS, JavaScript, and local image assets.
|
|
|
|
## Repo Layout
|
|
|
|
- `templates/index.html`: source template for the main gallery page
|
|
- `templates/rankings.html`: source template for the rankings page
|
|
- `index.html`: generated static gallery page
|
|
- `rankings.html`: generated static rankings page
|
|
- `assets/`: site CSS, JavaScript, fonts, and audio
|
|
- `images/fulls/`: full-size gallery images
|
|
- `images/thumbs/`: gallery thumbnails
|
|
- `data/meals.json`: source of truth for gallery entries
|
|
- `data/elo.json`: Elo ratings, record totals, and ranking settings
|
|
- `scripts/build.js`: renders static pages from templates and data
|
|
- `scripts/generate-thumbnails.js`: regenerates thumbnails from the full-size images
|
|
- `scripts/ingest-meal.js`: ingests a new meal image and metadata in one command
|
|
- `scripts/lib/elo.js`: validates and syncs Elo data against the meal list
|
|
- `package.json`: minimal Node build entrypoint
|
|
|
|
## Content Workflow
|
|
|
|
Gallery entries live in `data/meals.json`, and the build generates both `index.html` and `rankings.html` from the template and data files.
|
|
|
|
After editing content or templates, rebuild the site with:
|
|
|
|
```sh
|
|
npm run build
|
|
```
|
|
|
|
The gallery build keeps the existing Lens thumbnail markup intact, so the current client-side viewer code continues to work.
|
|
|
|
To ingest a new meal image and update the site in one command, run:
|
|
|
|
```sh
|
|
npm run ingest -- --image /path/to/photo.jpg --title "meal title" --description "notes"
|
|
```
|
|
|
|
Optional ingestion flags:
|
|
|
|
- `--position "left center"` sets the viewer image alignment
|
|
- `--focus-x 0.35 --focus-y 0.45` sets the thumbnail crop focal point
|
|
|
|
If you only need to regenerate thumbnails, run:
|
|
|
|
```sh
|
|
npm run build:thumbs
|
|
```
|
|
|
|
To force a full thumbnail rebuild, run:
|
|
|
|
```sh
|
|
npm run build:thumbs:force
|
|
```
|
|
|
|
## Rankings Data
|
|
|
|
`data/elo.json` stores the seed rating, Elo `kFactor`, and a win-loss record for each meal.
|
|
The page build keeps this file aligned with `data/meals.json`, so new meals automatically appear in `rankings.html` with the default seed rating.
|
|
|
|
## Image Conventions
|
|
|
|
- Full-size images and thumbnails share the same numeric ID
|
|
- Full-size images live at `images/fulls/<id>.jpg`
|
|
- Thumbnails live at `images/thumbs/<id>.jpg`
|
|
- `position` controls the full-screen viewer image alignment
|
|
- `thumbnail.focus` optionally overrides the default center crop for generated thumbnails
|
|
|
|
## Thumbnail Focus
|
|
|
|
Thumbnails are generated from `images/fulls` with `sharp` at `240x320`.
|
|
The generator auto-rotates images using EXIF orientation, skips unchanged files by default, and removes stale thumbnail `.jpg` files that no longer map to a meal entry.
|
|
|
|
For images that should crop away from the center, add optional thumbnail focus metadata to the meal entry:
|
|
|
|
```json
|
|
{
|
|
"id": "34",
|
|
"title": "example",
|
|
"description": "example",
|
|
"thumbnail": {
|
|
"focus": {
|
|
"x": 0.35,
|
|
"y": 0.45
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
The `x` and `y` values are normalized from `0` to `1`, where `0.5, 0.5` is the center of the image.
|
|
|
|
## Planned Features
|
|
|
|
1. A pairwise voting page that shows two food images at a time and updates Elo rankings based on the selected winner.
|
|
2. General cleanup and history cleanup once the bigger structural changes are in place.
|