calevans/staticforge-template-aperture

A visual-first portfolio template.

1.0.1 2026-01-22 20:40 UTC

Requires

• calevans/staticforge-gallery: ^1.1

MIT

• Cal Evans

README

Aperture is a visual-first, dark-mode portfolio theme designed for photographers and visual artists.

Features

• Immersive Design: Dark canvas (#111111) with cinematic hover effects.
• Masonry Grid: Full-width, responsive grid that respects aspect ratios.
• Clean Typography: Uses Playfair Display and Open Sans for an editorial look.
• StaticForge Gallery: Fully integrated with the calevans/gallery shortcode plugin.

Installation

composer require calevans/staticforge-theme-aperture

Configuration

Set the theme in your siteconfig.yaml:

site:
  template: aperture

Menu Setup

This theme uses the menu1 variable for the sidebar navigation.

menu:
  top:
    Home: /
    Gallery: /photography.html
    About: /about
    Contact: /contact

Gallery Usage

This theme comes with the calevans/staticforge-gallery plugin pre-configured. To create a gallery page:

1. Place your images in a folder inside your content structure (e.g., content/assets/images/portfolio).
2. Create a markdown file (e.g., content/gallery.md).
3. Use the [[gallery]] shortcode in your content:

---
title: My Portfolio
description: A collection of my work
---

# My Work

[[gallery path="assets/images/portfolio" id="my-portfolio-grid" rowHeight="300" margins="15"]]

Shortcode Attributes

• path: Required. Relative path to images (e.g. assets/images/portfolio).
• id: Required. A unique ID for the gallery container.
• rowHeight: (Optional) Height of rows in pixels (default: 200).
• margins: (Optional) Gap between images (default: 10).
• lastRow: (Optional) Behavior of the last row: nojustify (default), justify, hide, center.

License

MIT