Repository navigation
v0.7.1
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| ttranslation 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.needsRebuildWithTextreplacesneedsRebuildWithDeps, comparing the source text hash rather than relying on mtime. Editing a file without advancing its timestamp is now detected. - Per-template diffing.
loadCachenow 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, andgetIncludePathMap. Previously only the top-level layout was recorded. - Cache writes are keyed by output path.
updateCacheWithHashnow takes theoutPathexplicitly, keeping the dependency and page caches consistent.
Layout and Include Loading
- Timestamp caching removed from
loadLayoutsandloadIncludes. 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.
setIncludesMtimewas replaced bysetIncludesSignature, which invalidates the include-substituted layout cache when the content of any include changes — again, independent of timestamps. - Processed-layout cache key.
applyLayoutCachednow keys onpath | layoutHash | includesSignatureinstead ofpath | mtime. - Include path map merging.
BuildEnginenow 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 (includingfsi-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. ThemarkPhasecalls 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
IDictionaryvalues, removing the second widening pass and copy inloadLocales. formatTextappends 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 thanToString().Trim('"'). Directory.GetFilesreplaced withDirectory.EnumerateFiles.
Metadata (MetaParser.fs)
parseTomlWithLinesnow returnsoption, 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
tagSplitPatreplaces an inlineRegex.Splitcall. applyDefaultlowercases the key once so recognized keys andExtraentries share a single spelling.
Routing (PermalinkRouter.fs)
slugifyremoves invalid characters before collapsing hyphens, so punctuation between two words can no longer leave a doubled hyphen.computePermalinkanddefaultRoutenormalize the directory once and reuse it for both URL segments and file paths.
Theme (ThemeResolver.fs, ThemeConfigLoader.fs)
git clonenow 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.
paththeme resolution wrapsGetFullPathin a try/with so a malformed path is reported instead of throwing.- Theme manifest parsing cleaned up with
tryGetStringandOption.orElse/Option.defaultValue, and pre-sized dictionaries. ThemeResolverdocumentation now states the invariant thatresolvenever throws for a bad source.
Documentation
README.mdsubstantially revised (large diff).src/Zest.App/Starters/README.mdrewritten to describe the single-article scaffold.src/Zest.App/Starters/_config.tomlreduced to site metadata, build options, a[theme]block, and a single[[taxonomies]]entry forseries(keeping the starter free of generated/tags/pages).Directory.Build.propsandzest.tomlbumped to0.7.1.
Internal Notes
BuildLayout.setIncludesMtimerenamed tosetIncludesSignature.LayoutEngine.currentIncludesMtimerenamed tocurrentIncludesSignature.LayoutEngine.getLastIncludesMtimereplaced bygetIncludePathMap/setIncludePathMap.- Starter
Zest.App.csprojembedded resource list updated to match the reduced file set;_init.zest.fsxis no longer embedded. atom.zest.fsx,rss.zest.fsx, andsitemap.zest.fsxnow filter articles byp.date <> ""instead of a/posts/URL prefix, matching the single-article layout.
Full Changelog: v0.7.0...v0.7.1