Creating Pages

Revela provides commands to quickly create new pages. You can create:

📷 Gallery Pages

Photo collections with optional introductory text and sorting options.

📝 Text Pages

Content pages without image gallery (About, Contact, Imprint).

📊 Statistics Pages

EXIF analysis showing camera and lens usage statistics.

Available Page Types

Type	Description	Template
`gallery`	Photo gallery with image grid	Default (body/gallery)
`text`	Text-only page without images	page
`statistics`	EXIF statistics	statistics/overview

Gallery Pages

Create a new gallery for your photos:

# Simple gallery
revela create page gallery vacation --title "Summer Vacation 2024"

# With description and sorting
revela create page gallery best-shots --title "Highlights" \
    --description "My best shots" \
    --sort "exif.raw.Rating:desc"

# Hidden gallery (not in navigation)
revela create page gallery drafts --title "Drafts" --hidden

Options

Option	Alias	Description	Default
`--title`	`-t`	Page title	"Gallery"
`--description`	`-d`	Description (for SEO)	""
`--sort`	`-s`	Override sorting	(global)
`--hidden`	-	Hide from navigation	false
`--slug`	-	Custom URL segment	(folder name)

Sort Options

--sort "dateTaken:asc"        # Oldest first
--sort "dateTaken:desc"       # Newest first
--sort "filename:asc"         # A → Z
--sort "exif.raw.Rating:desc" # Highest rating first

Text Pages

Create pages without image gallery (About, Contact, Imprint):

# About page
revela create page text about --title "About Me" \
    --description "Learn more about me and my photography"

# Contact page
revela create page text contact --title "Contact"

# Imprint (hidden from navigation)
revela create page text imprint --title "Imprint" --hidden

Generated File

+++
title = "About Me"
description = "Learn more about me and my photography"
template = "page"
+++
Write your content here using **Markdown**.

## Example Heading

- List item one
- List item two

Statistics Pages

Create a page with EXIF statistics of your photo collection:

revela create page statistics stats --title "Photo Statistics" \
    --description "Analysis of my camera and lens usage"

Note: The Statistics plugin must be installed (revela plugin install Statistics).

Interactive Mode

All page types support an interactive mode. Start without the path argument:

revela create page gallery
revela create page text
revela create page statistics

The wizard guides you through all options:

Enter path - Relative path to source/
Title - Enter page title
Description - Optional description
Sorting (gallery only) - Choose from presets or enter custom
Hidden - Hide from navigation?
Confirm - Create file?

Frontmatter Fields

All Page Types

Field	Description
`title`	Page title (in navigation and `<title>`)
`description`	SEO description
`hidden`	`true` = not in navigation (but accessible via URL)
`slug`	Overrides URL segment (last segment only)
`template`	Body template (default: `gallery` or `page`)

Gallery Pages Only

Field	Description
`sort`	Override image sorting (e.g., `dateTaken:asc`)

Folder Structure

Pages are always created in the source/ directory:

source/
├── vacation/
│   └── _index.revela      ← revela create page gallery vacation
├── about/
│   └── _index.revela      ← revela create page text about
└── stats/
    └── _index.revela      ← revela create page statistics stats

Nested paths are supported:

revela create page gallery "2024/summer/italy" --title "Italy 2024"
# Creates: source/2024/summer/italy/_index.revela

The order in navigation is determined by folder names:

source/
├── 01 Galleries/
│   ├── 01 Landscape/
│   └── 02 Portrait/
├── 02 About/
└── 03 Contact/

Use number prefixes for desired sorting. Numbers are stripped from the display title.

Menu i i i Revela