Skip to main content

Module theme_manifest

Module theme_manifest 

Source
Expand description

Theme manifest compatibility check.

A theme declares the oldest generator it works with:

# themes/atlas/theme.toml
min_version = "0.0.50"

Nothing used to read it. That mattered because the ways a too-old generator breaks a theme are all silent: before v0.0.50 the layout named in front matter was ignored and every page rendered through page.html, a bundled content.schema.toml aborted the compile with an unrelated message, and extracted CSS 404’d under a sub-path. A user on an older release got a build that succeeded and a site that was wrong.

This turns that into one clear error at the start of the build.

Functions§

check_theme_compatibility
Fails the build when the theme requires a newer generator than this one.