Built-in Data Sources

System integration with datetime, git, and environment sources

File Metadata Source

The metadata data source provides filesystem metadata (size, modification time, etc.) for files using page context resolution. When enabled as inline content, the size and mtime tokens are automatically resolved to the current page’s file.

Current Page Metadata

Basic Information

Filename:
metadata.html
Extension:
.html
Basename (no extension):
metadata

File Size

Size in bytes:
3827 bytes
Human-readable:
3.7 KB
Estimated reading time (250 WPM):
~3m

Timestamps (Build-Time)

Modification time (Unix timestamp):
1780430657
ISO format:
2026-06-02T16:04:17
RFC 3339 format:
2026-06-02T16:04:17-04:00
Date only:
2026-06-02
Time only:
16:04:17

How It Works

  1. Page Context Resolution: The metadata source uses the current template's output path as the lookup key in the Universal Index.
  2. Zero-Cost Abstraction: Metadata is read once during index construction, then cached for all lookups.
  3. Build-Time Values: All metadata reflects the state at build time, not when the HTML is viewed.
  4. Template Pages: When using template generation, each generated page gets its own metadata based on its template file.

Note: The metadata source must be configured as options = ["inline"] because tokens appear within page content, not as separate include files.

Configuration

[[step]]
emoji = "📁"
path = "data-files/"
processing = "include"
type = "metadata"
options = ["inline"]  # Required for inline tokens

Page-Specific Metadata

Each page's metadata reflects its source file in the Universal Index. Template-generated pages use the template file's metadata, while manually-created pages use their own metadata.

Example Usage:

This page is 3.7 KB and takes about ~3m to read. Last modified on 2026-06-02.