Files
immich-folio/content/settings.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

81 lines
3.5 KiB
Plaintext

# ── Global Site Settings ──────────────────────────────────────────
# This file controls the visual identity, global behavior, and legal info.
# Structure is separated from gallery.yaml (album IDs) for clarity.
# Public site title and subtitle (overrides .env if set)
title: "My Portfolio"
subtitle: "A visual journal"
# ── SEO & Metadata ───────────────────────────────────────────────
# Optional: Overrides global title/subtitle for search engines and social cards
# seo:
# title: "My Portfolio | Photography"
# description: "A curated selection of my best photography work."
# titleTemplate: "%s | My Portfolio" # Template for subpages (%s is replaced with subpage/album title)
# noIndex: false # Set to true to hide from search engines
# noFollow: false # Set to true to prevent search engines from following links
# Show EXIF metadata (camera, lens, ISO) on photo grid hover
exifOnHover: true
# Enable the interactive world map view (/map)
map: true
# Enable smooth page transitions between routes
transitions: true
# Show the floating back-to-top arrow on long pages
scrollToTop: true
# Client proofing & favorite photo selections
# proofing:
# enabled: true
# allowMailto: true
# ── Theme configuration ──────────────────────────────────────────
# Presets: studio, studio-modern, minimal, editorial, classic, noir, monograph
theme:
preset: "studio"
# accent: "#e60012"
# photoFrame: "passepartout" # none, passepartout, shadow
# grain: true
# heroStyle: "split" # split, fullbleed, minimal, stacked, typographic, mosaic, cover (EXPERIMENTAL)
# Note: "mosaic" needs at least 3 hero images in gallery.yaml (optimal: 6)
# ── Grid configuration ───────────────────────────────────────────
grid:
columns: 3
gap: 12
aspectRatio: "1" # "1" (square), "3/2", "2/3", "16/9", "auto"
layout: "masonry" # masonry, uniform, showcase, filmstrip, editorial-flow, justified (EXPERIMENTAL)
# ── Navigation ────────────────────────────────────────────────────
# EXPERIMENTAL: external links appended to the header navigation.
# Only http(s) URLs are allowed; they open in a new tab.
# navLinks:
# - label: "Shop"
# url: "https://shop.example.com"
# - label: "Instagram"
# url: "https://instagram.com/your-handle"
# ── Footer & Social ──────────────────────────────────────────────
footer:
name: "My Photography"
instagram: "https://instagram.com/your-handle"
email: "hello@example.com"
website: "https://example.com"
# ── Legal / Impressum (German Law compliance) ────────────────────
# If enabled: true, a link to /impressum will appear in the footer.
legal:
enabled: false
name: "Your Full Name"
address: "Street and House Number"
zipCity: "ZIP Code and City"
country: "Germany"
email: "legal@example.com"
phone: "+49 123 456789"
# taxId: "DE123456789"
# vatId: "12/345/67890"
extraInfo: "Verantwortlich für den Inhalt nach § 18 Abs. 2 MStV: Max Mustermann"