Skip to content

v0.7.1

Choose a tag to compare

@github-actions github-actions released this 11 Sep 18:11
· 5 commits to main since this release

Zest SSG v0.7.1 — Release Notes

Released: September 12, 2026
Range: 0.7.0 → 0.7.1 (6 commits, 62 files changed, +1,088 / −2,973)

This is a focused follow-up to 0.7.0. The two themes are a substantially reworked incremental cache that now rebuilds only genuinely changed pages, and a drastic simplification of the bundled starter theme into a single-article LaTeX-style "paper" design. A number of i18n, metadata, routing, and theme modules were also tightened up.


Breaking Changes (Starter Template Only)

The zest init scaffold was reduced from a full blog to a single-article site. If you were relying on the old starter as a reference, note that the following were removed from the template:

  • _init.zest.fsx, _data/nav.toml, and theme _data/nav.toml
  • Locales (_locales/en.toml, _locales/zh.toml) and the | t translation usage
  • Layouts base.html, default.html, home.html, tag.html, tags.html, terms.html
  • Includes footer.html, page-shell.html, themevars.html
  • Content pages 404, about, archives, features, index.zest.fsx, search, tags
  • All sample posts plus content/posts/index.njk
  • The split ZCSS slices (tokens, base, components, pages, responsive)

The site is now one Markdown article (content/index.md) rendered through a single post layout, with rss.zest.fsx, atom.zest.fsx, and sitemap.zest.fsx retained. Styles were consolidated into a single main.zcss.

The theme manifest was reset accordingly: oxygen is now version 1.0.0, author exyone, license BSD-2-Clause, description "The default theme for Zest SSG."

Note that this affects only newly generated sites. Existing projects are unaffected.


Incremental Build Correctness

This is the headline fix. The previous cache keyed staleness on file modification time and a global template signature, which in practice rebuilt more than necessary and could miss changes.

  • Content-hash based staleness. BuildCache.needsRebuildWithText replaces needsRebuildWithDeps, comparing the source text hash rather than relying on mtime. Editing a file without advancing its timestamp is now detected.
  • Per-template diffing. loadCache now takes a list of (templatePath, templateText) pairs instead of a single signature. It diffs each template's content hash and marks only the pages that depend on a changed template as stale, so editing one layout rebuilds the affected pages rather than the whole site.
  • Per-page dependency tracking is broader. During the write phase, each page records a dependency on every level of its layout chain plus every include those layouts reference, resolved via the new LayoutEngine.layoutChain, collectIncludePaths, and getIncludePathMap. Previously only the top-level layout was recorded.
  • Cache writes are keyed by output path. updateCacheWithHash now takes the outPath explicitly, keeping the dependency and page caches consistent.

Layout and Include Loading

  • Timestamp caching removed from loadLayouts and loadIncludes. Files are now read on every call. The rationale, documented in the code, is that an editor can rewrite a file without advancing its modification time; reading a handful of templates is negligible next to rendering the site.
  • Include-set content signature. setIncludesMtime was replaced by setIncludesSignature, which invalidates the include-substituted layout cache when the content of any include changes — again, independent of timestamps.
  • Processed-layout cache key. applyLayoutCached now keys on path | layoutHash | includesSignature instead of path | mtime.
  • Include path map merging. BuildEngine now merges the theme and project include path maps so a page can resolve which include files it depends on, with project entries winning.

Build Diagnostics

  • Timing output trimmed. The per-phase [Zest][timing] instrumentation added in 0.7.0 (including fsi-cold-start, content-batchlayout, html-format, content-write, taxonomy-render, and the pagination/taxonomy sub-phases) was removed in favor of the simplified build-time prompt introduced in this release. The markPhase calls that remain use shorter labels (setup, content, assets).

Module Optimizations

The commit "Optimize i18n, metadata, routing, and theme modules" touched several subsystems:

I18n (LocaleLoader.fs)

  • Inner locale dictionaries are now built directly as IDictionary values, removing the second widening pass and copy in loadLocales.
  • formatText appends literal runs in bulk instead of character by character.
  • A shared empty argument bag avoids allocating a dictionary for lookups without interpolation.
  • JSON array values are read via GetString() rather than ToString().Trim('"').
  • Directory.GetFiles replaced with Directory.EnumerateFiles.

Metadata (MetaParser.fs)

  • parseTomlWithLines now returns option, so a malformed +++ block degrades to the extension-specific parser instead of being silently ignored — and reports the parse failure via a warning.
  • The F# comment header scan is index-based and stops at the first content line rather than walking the whole body.
  • Compiled tagSplitPat replaces an inline Regex.Split call.
  • applyDefault lowercases the key once so recognized keys and Extra entries share a single spelling.

Routing (PermalinkRouter.fs)

  • slugify removes invalid characters before collapsing hyphens, so punctuation between two words can no longer leave a doubled hyphen.
  • computePermalink and defaultRoute normalize the directory once and reuse it for both URL segments and file paths.

Theme (ThemeResolver.fs, ThemeConfigLoader.fs)

  • git clone now drains stdout and stderr before waiting, avoiding a pipe-buffer deadlock on verbose clones; a timeout kills the process tree and cleans up the partial cache entry.
  • URL theme caching tests for any filesystem entry, not just files, so a theme whose root contains only directories is still a valid cache hit.
  • path theme resolution wraps GetFullPath in a try/with so a malformed path is reported instead of throwing.
  • Theme manifest parsing cleaned up with tryGetString and Option.orElse/Option.defaultValue, and pre-sized dictionaries.
  • ThemeResolver documentation now states the invariant that resolve never throws for a bad source.

Documentation

  • README.md substantially revised (large diff).
  • src/Zest.App/Starters/README.md rewritten to describe the single-article scaffold.
  • src/Zest.App/Starters/_config.toml reduced to site metadata, build options, a [theme] block, and a single [[taxonomies]] entry for series (keeping the starter free of generated /tags/ pages).
  • Directory.Build.props and zest.toml bumped to 0.7.1.

Internal Notes

  • BuildLayout.setIncludesMtime renamed to setIncludesSignature.
  • LayoutEngine.currentIncludesMtime renamed to currentIncludesSignature.
  • LayoutEngine.getLastIncludesMtime replaced by getIncludePathMap / setIncludePathMap.
  • Starter Zest.App.csproj embedded resource list updated to match the reduced file set; _init.zest.fsx is no longer embedded.
  • atom.zest.fsx, rss.zest.fsx, and sitemap.zest.fsx now filter articles by p.date <> "" instead of a /posts/ URL prefix, matching the single-article layout.

Full Changelog: v0.7.0...v0.7.1