feat(templates): migrate to Zola 0.23 and Tera 2 - #181
Draft
forkwright wants to merge 2 commits into
Draft
Conversation
added 2 commits
August 19, 2026 20:42
Move the shared substrate to the pinned Zola 0.23.3 renderer, migrate the complete template dialect to collision-resistant Tera 2 components, and add static plus GitHub-rendered compatibility contracts. This is the separately gated prerequisite for scoped root-feed semantics; it does not close the feed issue. Refs #179
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
typikon.*Tera 2 components;include_in_feeds, ordering, and limit behavior;sameAsaccumulation.This is the separately gated renderer prerequisite for #179. It intentionally does not implement or close the scoped-root-feed issue.
Why this is separate
Zola 0.22.1 does not parse or expose the
include_in_feedspage field required by #179 acceptance item 4. The field is native in Zola 0.23, but that release also moves the renderer to Tera 2. A version-only bump would break Typikon's macro imports, namespace calls, removed collection/string filters, and positional test arguments.Keeping this migration separate gives the renderer transition its own exact-head proof before feed membership semantics are layered onto refreshed
main.Compatibility contract
theme.toml, Typikon's own gate,bin/typikon-defaults.sh, and both generated consumer gate templates agree on Zola 0.23.3 and SHA-256f07c92607e5745268b576bd325ceef3a582aada253bb64db8d92a8a85303d958.zola-v0.23.3-x86_64-unknown-linux-gnu.tar.gz.typikon.*namespace because Tera 2 registers components globally and consumer templates can otherwise replace theme internals.configand the current page/section language explicitly.Verification before push
git diff --check: clean.python3 ci/check-tera2-contract.py: pass.ci/run-fixtures.sh --listcorpus.bin/typikon-validate examples/sample-blog: 5/5.bin/typikon-validate examples/sample-shop: 11/11.No Zola build was run locally. This public repository's GitHub
full-gate-buildjob is the required authority for actual Zola 0.23.3 parsing/rendering, including the new isolated multilingual fixture. The PR should remain draft until that exact-head gate is terminal and reviewed.Refs #179