Configuration #

images.driver #

PHP image processing driver. Supported values: gd (default), imagick.

images:
  driver: imagick

images.presets #

Named transform presets. Each preset is a map of Glide parameters. Use a preset in content or templates with ?p=name (or ?preset=name).

images:
  presets:
    thumb:
      w: 320
      h: 180
      fit: crop
    hero:
      w: 1200
      h: 630
      fm: webp

Raw query parameters still work when presets are defined. Raw values override preset values when both are present in the same URL.

paths #

Each entry under paths is a rule with two keys:

• match (required) – path prefix; pages whose relativePath starts with this value are assigned to this type
• createPattern (optional) – path template used by glaze new when creating a page of this type

createPattern supports the {date:FORMAT} placeholder, which is replaced with today’s date formatted using PHP date format characters:

createPattern: blog/{date:Y/m}
# creates pages under: blog/2026/02/

createPattern: posts/{date:Y}
# creates pages under: posts/2026/

Shorthand path entries (a plain string instead of a map) are also supported and behave as a match-only rule with no createPattern:

contentTypes:
  docs:
    paths:
      - docs

defaults #

A metadata map merged into all pages of this type, before page frontmatter is applied. Page frontmatter always wins over type defaults.

defaults:
  template: blog
  draft: false
  meta:
    layout: wide

Explicit type override in frontmatter #

A page can declare its type directly in frontmatter, bypassing path matching:

---
type: blog
title: My post
---

The resolved type is available in templates as $page->type.

djot.codeHighlighting #

Controls syntax highlighting for fenced code blocks. Powered by Phiki.

djot:
  codeHighlighting:
    enabled: true
    theme: github-dark
    themes:
      dark: github-dark
      light: github-light
    withGutter: true

• enabled – enable or disable highlighting (default true)
• theme – single Phiki theme name (default nord); used when themes is not set
• themes – optional named theme map (name: theme) for multi-theme output (for example dark/light)
• withGutter – show line-number gutter beside code (default false)

When themes is configured, it takes precedence over theme. Glaze passes both named themes to Phiki, which emits CSS variables per named theme so you can switch colors in CSS.

Example with explicit dark/light mapping:

djot:
  codeHighlighting:
    themes:
      dark: github-dark
      light: github-light

djot.headerAnchors #

Injects anchor permalink links into headings during Djot rendering, powered by the vendor HeadingPermalinksExtension.

djot:
  headerAnchors:
    enabled: true
    symbol: "#"
    position: after
    cssClass: permalink-wrapper
    ariaLabel: Anchor link
    levels: [2, 3, 4]

• enabled – enable or disable heading anchor injection (default false)
• symbol – anchor text shown inside the heading link (default #)
• position – link placement, either before or after heading text (default after)
• cssClass – CSS class added to each anchor link (default permalink-wrapper)
• ariaLabel – accessibility label for anchor links (default Anchor link)
• levels – heading levels that get anchors (defaults to [1, 2, 3, 4, 5, 6])

djot.autolink #

Automatically converts bare URLs in the document into anchor links.

djot:
  autolink:
    enabled: true
    allowedSchemes: [https, http, mailto]

• enabled – enable or disable autolinking (default false)
• allowedSchemes – URL schemes to linkify (default [https, http, mailto])

djot.externalLinks #

Adds configurable attributes to external links. Internal hosts are excluded.

djot:
  externalLinks:
    enabled: true
    internalHosts: [example.com]
    target: _blank
    rel: noopener noreferrer
    nofollow: false

• enabled – enable or disable external link enrichment (default false)
• internalHosts – list of hostnames treated as internal; matching links are left unchanged
• target – target attribute added to external links (default _blank)
• rel – rel attribute added to external links (default noopener noreferrer)
• nofollow – append nofollow to the rel attribute (default false)

djot.smartQuotes #

Replaces straight quotation marks with typographic curly quotes. Locale-based defaults are applied when no explicit characters are given.

djot:
  smartQuotes:
    enabled: true
    locale: en

• enabled – enable or disable smart quote conversion (default false)
• locale – locale used for quote character defaults, e.g. en, de, fr (default null)
• openDouble – explicit opening double-quote character; overrides locale default (default null)
• closeDouble – explicit closing double-quote character; overrides locale default (default null)
• openSingle – explicit opening single-quote character; overrides locale default (default null)
• closeSingle – explicit closing single-quote character; overrides locale default (default null)

djot.mentions #

Converts @username references into links using a configurable URL template.

djot:
  mentions:
    enabled: true
    urlTemplate: '/users/view/{username}'
    cssClass: mention

• enabled – enable or disable mention expansion (default false)
• urlTemplate – URL template for mention links; {username} is replaced with the matched username (default /users/view/{username})
• cssClass – CSS class added to rendered mention links (default mention)

djot.semanticSpan #

Promotes spans with special class attributes to their semantic HTML equivalents.

Supported mappings: {mark=...} → <mark>, {ins=...} → <ins>, {del=...} → <del>, {kbd=...} → <kbd>.

djot:
  semanticSpan:
    enabled: true

• enabled – enable or disable semantic span promotion (default false)

djot.defaultAttributes #

Injects default HTML attributes onto Djot elements at render time.

djot:
  defaultAttributes:
    enabled: true
    defaults:
      heading:
        class: my-heading
      paragraph:
        class: prose

• enabled – enable or disable default attribute injection (default false)
• defaults – map of element type names to attribute maps; keys are Djot node type names (e.g. heading, paragraph, code_block), values are attribute name → value maps

djot Table of Contents #

Glaze can generate a table of contents from Djot headings in a single render pass.

Inline TOC directive

Place [[toc]] as a standalone paragraph in your Djot source to inject the table of contents at that position:

[[toc]]

## Introduction

## Installation

Template access

The $page->toc property holds the collected TocEntry list in document order:

<?php foreach ($page->toc as $entry): ?>
<a href="#<?= $entry->id ?>"><?= $entry->text ?></a>
<?php endforeach; ?>

Each TocEntry exposes:

• $entry->level – heading level (1–6)
• $entry->id – anchor id matching the rendered heading element
• $entry->text – plain-text heading label

build.vite #

Nested Vite build settings under build.

build:
  vite:
    enabled: false
    command: "npm run build"
    assetBaseUrl: /
    manifestPath: public/.vite/manifest.json
    defaultEntry: css/site.css

• enabled – opt-in default for Vite build integration (false by default)
• command – command used to run Vite build in the project root
• assetBaseUrl – base URL used for generated script/link tags in production mode
• manifestPath – manifest file path for Vite production assets
• defaultEntry – default entry used when s:vite receives no explicit entry