Revela

Source Structure

Revela supports two approaches for organizing your photos, and you can combine them in the same project:

Overview

๐Ÿ“ Traditional Galleries

Photos belong to one gallery. Images stored directly in the gallery folder.

๐Ÿ” Filter Galleries

Photos appear in multiple galleries. All images in a shared _images/ folder.

๐Ÿ”€ Hybrid Approach

Mix both approaches. Some galleries with local images, others with filters.

Traditional Galleries

Each gallery contains its own images directly in the folder.

source/
โ”œโ”€โ”€ _index.revela          # Homepage
โ”œโ”€โ”€ events/
โ”‚   โ”œโ”€โ”€ _index.revela      # Gallery page
โ”‚   โ”œโ”€โ”€ event-001.jpg
โ”‚   โ””โ”€โ”€ event-002.jpg
โ”œโ”€โ”€ portraits/
โ”‚   โ”œโ”€โ”€ _index.revela
โ”‚   โ””โ”€โ”€ portrait-001.jpg
โ””โ”€โ”€ landscapes/
    โ”œโ”€โ”€ _index.revela
    โ””โ”€โ”€ mountain.jpg

Characteristics

Filter Galleries

All images are stored in a shared _images/ folder. Galleries use filter expressions to select which images to display.

source/
โ”œโ”€โ”€ _index.revela          # Homepage
โ”œโ”€โ”€ _images/               # Shared image pool
โ”‚   โ”œโ”€โ”€ canon-event-001.jpg
โ”‚   โ”œโ”€โ”€ sony-landscape-002.jpg
โ”‚   โ””โ”€โ”€ sony-portrait-003.jpg
โ”œโ”€โ”€ canon/
โ”‚   โ””โ”€โ”€ _index.revela      # filter = "exif.make == 'Canon'"
โ”œโ”€โ”€ sony/
โ”‚   โ””โ”€โ”€ _index.revela      # filter = "exif.make == 'Sony'"
โ””โ”€โ”€ portraits/
    โ””โ”€โ”€ _index.revela      # filter = "contains(filename, 'portrait')"

The _images/ Folder

The underscore prefix is significant:

Example Front Matter

+++
title = "Canon Photos"
description = "All photos taken with Canon cameras"
filter = "exif.make == 'Canon'"
+++

Hybrid Approach

Combine both approaches in the same project:

source/
โ”œโ”€โ”€ _images/                   # Shared pool for filter galleries
โ”‚   โ”œโ”€โ”€ 2024-trip-001.jpg
โ”‚   โ””โ”€โ”€ 2025-event-001.jpg
โ”‚
โ”œโ”€โ”€ by-year/                   # Filter galleries
โ”‚   โ”œโ”€โ”€ 2024/
โ”‚   โ”‚   โ””โ”€โ”€ _index.revela      # filter = "year(dateTaken) == 2024"
โ”‚   โ””โ”€โ”€ 2025/
โ”‚       โ””โ”€โ”€ _index.revela      # filter = "year(dateTaken) == 2025"
โ”‚
โ””โ”€โ”€ clients/                   # Traditional galleries (exclusive)
    โ””โ”€โ”€ wedding-smith/
        โ”œโ”€โ”€ _index.revela
        โ””โ”€โ”€ ceremony-001.jpg   # Only in this gallery

Choosing the Right Approach

๐Ÿ“ท Simple Portfolio

Use Traditional - each photo belongs to one gallery.

๐Ÿท๏ธ Multiple Categories

Use Filter - photos can appear in many galleries based on metadata.

๐Ÿ”’ Client Work

Use Traditional - exclusive galleries for private content.

๐Ÿ“… By Camera / By Year

Use Filter - dynamic views based on EXIF data.

๐Ÿ”€ Mixed Content

Use Hybrid - combine both approaches as needed.

Common Patterns

Homepage with Recent Photos

+++
title = "Welcome"
filter = "all | sort dateTaken desc | limit 6"
+++

Category Landing Page (No Images)

+++
title = "Browse by Camera"
template = "page"
+++

Select a camera brand below.

Nested Filter Galleries

Filter galleries can be nested under plain page containers for deep, browsable hierarchies:

source/
โ”œโ”€โ”€ _images/
โ”œโ”€โ”€ gear/
โ”‚   โ”œโ”€โ”€ _index.revela          # template = "page" (no images)
โ”‚   โ”œโ”€โ”€ cameras/
โ”‚   โ”‚   โ”œโ”€โ”€ _index.revela      # template = "page"
โ”‚   โ”‚   โ”œโ”€โ”€ canon/
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ _index.revela  # filter = "exif.make == 'Canon'"
โ”‚   โ”‚   โ””โ”€โ”€ sony/
โ”‚   โ”‚       โ””โ”€โ”€ _index.revela  # filter = "exif.make == 'Sony'"
โ”‚   โ””โ”€โ”€ lenses/
โ”‚       โ”œโ”€โ”€ _index.revela      # template = "page"
โ”‚       โ”œโ”€โ”€ wide/
โ”‚       โ”‚   โ””โ”€โ”€ _index.revela  # filter = "exif.focalLength <= 35"
โ”‚       โ””โ”€โ”€ tele/
โ”‚           โ””โ”€โ”€ _index.revela  # filter = "exif.focalLength >= 85"

Migration Tips

From Traditional to Filter

  1. Create an _images/ folder
  2. Move images from galleries into _images/
  3. Add filter = "..." to each gallery's _index.revela
  4. Make sure images have the EXIF data or naming convention your filters rely on

Adding Filter Galleries to an Existing Site

  1. Create an _images/ folder
  2. Copy (or move) the images you want cross-referenced
  3. Create new filter gallery folders with an _index.revela
  4. Leave your traditional galleries unchanged

See Also