Files
immich-folio/content/gallery.yaml.example
Ralksta 84c7eeef40 experimental: portfolio features (justified layout, unlisted pages, captions, per-album grid, focal point, nav links, cover hero) (#431)
## Was ist das?

Sieben neue Portfolio-Features, alle als **experimental** gekennzeichnet
— in YAML-Kommentaren, Admin-Panel-Labels und Commit-Scopes, damit sie
einzeln nachvollziehbar und revertierbar bleiben.

## Features (je ein Commit)

| Commit | Feature |
| --- | --- |
| `justified rows gallery layout` | Neues Grid-Layout `justified`:
zeilenbasiert, gleiche Höhen, volle Breite — Flexbox ohne JS-Messung,
letzte Zeile bleibt natürlich klein |
| `hide subpages from navigation` | `hidden: true`: Seite aus
Nav/Homepage raus, per Direktlink erreichbar — im Gegensatz zu `enabled:
false` (404) |
| `lightbox captions` | Immich-Asset-Description als Bildunterschrift im
Info-Panel; EXIF-Route liefert bei `exifOnHover: false` jetzt nur noch
die Caption statt 403 |
| `per-album grid overrides` | `grid:` pro Album-Eintrag, Präzedenz
global < Subpage < Album |
| `per-album cover focal point` | `coverPosition:` → `object-position`
auf Cover-Karten, strikt validiert |
| `external links in header navigation` | `navLinks:` in settings.yaml,
nur http(s), sanitisiert |
| `cover splash hero style` | `heroStyle: cover`: Fullscreen-Splash mit
Enter-Link ins Portfolio |

Alle Optionen sind im Admin-Panel editierbar (PageBuilder /
SettingsEditor).

## Tests

- 356 Unit-Tests grün (13 neue: deriveGallery hidden/grid/coverPosition,
sanitizeNavLinks, EXIF-Route-Captions, justified-Layout-Validierung)
- `npx tsc --noEmit`: 0 Fehler
- `npm run build`: sauber
- Justified-Zeilenmathematik und Cover-Splash per Browser-Harness
visuell/numerisch verifiziert (volle Zeilen enden exakt an der
Containerkante, letzte Zeile bleibt natürlich)

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: ralksta <ralksta@users.noreply.github.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: lancetm714 <108419425+lancetm714@users.noreply.github.com>
2026-08-14 17:56:22 +02:00

104 lines
4.6 KiB
Plaintext

# ── Gallery Structure ──────────────────────────────────────────────
# This file defines WHICH albums and subpages are shown.
# Global settings (theme, map, legal, title) now live in content/settings.yaml.
# Hero images for the homepage carousel (Immich asset UUIDs)
hero:
- "your-asset-uuid-1"
- "your-asset-uuid-2"
# Standalone albums (shown on the home page)
#
# Photo order inside an album: by default a Folio album mirrors the Immich
# timeline. The optional `sort` key lets the portfolio order differ from the
# archive order, without changing anything in Immich.
#
# immich Default. Inherits the album's own asc/desc setting in Immich.
# This is capture-time order — Immich does not expose the drag
# order from its web UI, so Folio cannot reproduce that.
# newest Capture time, newest first, whatever Immich is set to.
# oldest Capture time, oldest first.
# filename originalFileName, natural order (IMG_2 before IMG_10).
# Matches scanned-film and camera-export workflows.
# manual Pinned photos first, in the order given by `assetOrder`;
# everything else follows in the album's Immich order. Far easier
# to set in /admin, which has a drag & drop editor for it.
#
# Two things worth knowing:
# • On a subpage with several albums, `sort` orders photos *within* each
# album — the albums themselves stay in the order they are listed in.
# • Lightbox permalinks (#photo-3) are positional, so changing an album's
# sort moves where a previously shared link lands.
#
# `sort` works the same on subpage and section albums, shown further down.
albums:
- "your-album-uuid-1" # no sort key → Immich order, exactly as before
- "your-album-uuid-2":
sort: filename # an entry may carry only a sort, with no title override
- "your-album-uuid-3":
title: "Hokkaido, in sequence"
sort: manual
assetOrder: # pinned, in this order. Everything else follows automatically.
- "asset-uuid-opening-frame"
- "asset-uuid-second-frame"
# Subpages: group albums under custom URL paths
subpages:
"Travel":
- "album-uuid-3"
- "album-uuid-4"
"Projects":
title: "My Creative Projects" # Optional: Header title, defaults to Navigation key ("Projects")
subtitle: "A collection of 2026 highlights in 35mm film." # Optional: Sub-text for headers
password: "your-password" # Optional protection
# hidden: true # EXPERIMENTAL: reachable by direct link, but not shown in navigation
albums:
- "album-uuid-5"
- "album-uuid-6":
title: "Private Project #7"
description: "Shot on 35mm film in Vienna, spring 2025." # Optional: shown below album title
password: "scrypt:..." # Recommended: secure hash (generated via logs)
# grid: # EXPERIMENTAL: per-album grid override (wins over page/global grid)
# layout: "justified"
# columns: 2
# coverPosition: "50% 25%" # EXPERIMENTAL: focal point for the cover crop ("top", "center bottom", "50% 25%")
# ── Subpage with Sections ──────────────────────────────────────────
# Use sections to group albums by location, theme, or any other logic.
# A typographic table of contents is rendered above the albums.
# Sections are optional: leave them out and you get a flat album grid (as above).
subpages:
- name: Japan
title: Japan
subtitle: "Reisen durch ein Land voller Kontraste."
sections:
- title: Tokyo
description: "Megacity, Neonlichter, Stille im Lärm."
albums:
- "album-uuid-tokyo-1" # Uses Immich album name
- "album-uuid-tokyo-2": Shinjuku bei Nacht # Custom title override
- "album-uuid-tokyo-3"
- title: Kyoto
description: "Tempel, Bambuswälder, goldener Herbst."
albums:
- "album-uuid-kyoto-1": Fushimi Inari
- "album-uuid-kyoto-2"
- title: Osaka
albums: # description is optional
- "album-uuid-osaka-1"
- "album-uuid-osaka-2"
# ── Photo Essay / Storytelling Subpage Example ───────────────────
# Render editorial Markdown essays with fullbleed & side-by-side images
- name: Highlands
title: "Icelandic Highlands"
subtitle: "A Photo Essay"
essayFile: "content/essays/sample-story.md"
grid:
layout: essay
albums:
- "album-uuid-iceland-1"