release: v0.12.0 (#520)

Forty-one commits since v0.11.0. See CHANGELOG.md for the full list and the upgrade notes.

content/gallery.yaml.example

@@ -42,16 +42,23 @@ albums:
         - "asset-uuid-opening-frame"
         - "asset-uuid-second-frame"
 
-# Subpages: group albums under custom URL paths
+# Subpages: group albums under custom URL paths.
+# One `subpages:` key for the whole file — every page below is one entry in it.
 subpages:
-  "Travel":
-    - "album-uuid-3"
-    - "album-uuid-4"
-  "Projects":
-    title: "My Creative Projects" # Optional: Header title, defaults to Navigation key ("Projects")
+  # Simple form: a name and its albums.
+  - name: Travel
+    albums:
+      - "album-uuid-3"
+      - "album-uuid-4"
+
+  - name: Projects
+    title: "My Creative Projects" # Optional: Header title, defaults to `name`
     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
+    # grid: # Optional per-page grid override (wins over settings.yaml)
+    #   columns: 3 # how many album covers per row on this page
+    #   gap: 8 # spacing between the covers, in px — omit to keep the theme's own
     albums:
       - "album-uuid-5"
       - "album-uuid-6":
@@ -63,11 +70,10 @@ subpages:
           #   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:
+  # ── 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).
   - name: Japan
     title: Japan
     subtitle: "Reisen durch ein Land voller Kontraste."

content/settings.yaml.example

@@ -6,6 +6,11 @@
 title: "My Portfolio"
 subtitle: "A visual journal"
 
+# Interface language of the visitor-facing site: "en" or "de".
+# Any other value still sets <html lang> and date formatting, but the
+# interface stays English. The admin panel is always English.
+lang: "en"
+
 # ── SEO & Metadata ───────────────────────────────────────────────
 # Optional: Overrides global title/subtitle for search engines and social cards
 # seo:
@@ -15,9 +20,31 @@ subtitle: "A visual journal"
 #   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
+# ── Site password (optional) ─────────────────────────────────────
+# Puts the WHOLE public site behind one password — useful while a portfolio
+# is still being built, or for a folio only ever shown to clients.
+# Log in once and the server log prints a scrypt: hash to paste back here.
+# The SITE_PASSWORD environment variable overrides this value.
+# /admin keeps its own password and is never behind this gate.
+# sitePassword: "scrypt:..."
+
+# What a first-time visitor sees: dark (default), light, or auto to follow
+# their operating system. Their own choice from the header toggle overrides it.
+mode: dark
+
+# Show the EXIF summary overlay on photo grid hover
 exifOnHover: true
 
+# Which EXIF groups the site may publish at all — the grid overlay, the
+# lightbox info panel and the album header all follow this.
+# caption is the description written in Immich; turn it off if you use that
+# field for private notes.
+# exif:
+#   camera: true      # body, lens, focal length
+#   settings: true    # aperture, shutter speed, ISO
+#   location: true    # city and country
+#   caption: true     # the Immich description
+
 # Enable the interactive world map view (/map)
 map: true
 
@@ -32,6 +59,13 @@ scrollToTop: true
 #   enabled: true
 #   allowMailto: true
 
+# Watermark overlay on the lightbox. opacity is a fraction: 0.5 = 50%.
+# watermark:
+#   enabled: true
+#   text: "© Your Name"
+#   opacity: 0.5
+#   position: "bottom-right"   # bottom-right | bottom-left | center
+
 # ── Theme configuration ──────────────────────────────────────────
 # Presets: studio-modern (default), studio, minimal, editorial, classic,
 #          noir, monograph