Skip to content

[V2:01] Prepare Theme for Local Build Rendering#11

Open
ritorhymes wants to merge 1 commit into
eips-wg:masterfrom
ritovision:v2/01-theme-external-requires
Open

[V2:01] Prepare Theme for Local Build Rendering#11
ritorhymes wants to merge 1 commit into
eips-wg:masterfrom
ritovision:v2/01-theme-external-requires

Conversation

@ritorhymes

@ritorhymes ritorhymes commented May 5, 2026

Copy link
Copy Markdown

Part of V2: Multi-repo local build system.

Summary

This PR is the theme-side foundation for the V2 multi-repo local build system. Its load-bearing change is rendering absolute requires entries as direct links so later targeted EIP/ERC builds can emit cross-repo proposal dependencies; the homepage badge restructuring and Zola 0.22.1 configuration updates are bundled theme-version updates that touch the same rendering and configuration surface.

  • Render absolute requires entries as direct links instead of resolving them as local Zola pages.
  • Move the theme demo homepage badges from inline markdown HTML into front matter, theme macros, and theme-owned styles.
  • Declare Zola 0.22.1 as the minimum supported version, enable bottom footnotes, and update markdown highlighting to the class-based config with github-light/dark themes and ABNF/CSL-JSON grammars.

Review Notes

This is the theme-side prerequisite for V2:15. Targeted --only rendering can rewrite cross-repo proposal dependencies into external URLs, and the theme needs to render those URLs directly instead of treating every requires entry as a local page reference.

The homepage badge change applies to the theme demo homepage. EIPs and ERCs do not need to provide homepage_badges in this stack; repositories without that front matter continue rendering their homepage content normally.

This PR does not add targeted rendering or change preprocessor behavior. It only updates theme rendering/configuration needed by the final local build flow.

Verification

  • Review templates/eip.html for external requires rendering.
  • Review content/_index.md, templates/index.html, templates/macros.html, and sass/assets/css/style.scss for demo homepage badge rendering and styling.
  • Review config.toml and theme.toml for the Zola 0.22.1, footnote, highlighting, and grammar configuration updates.

Render external requires entries as direct links without forcing Zola to
resolve them as local pages.

This supports targeted --only rendering, where cross-repo proposal
dependencies can be rewritten to external URLs instead of local pages.

Move the theme demo homepage badges into front matter, a homepage_badges
macro, and theme-owned styles so the demo homepage stays
markdown-friendly.

Declare Zola 0.22.1 as the minimum supported version, enable bottom
footnotes, and update markdown highlighting to the class-based config
with github-light/dark themes and ABNF/CSL-JSON grammars.
@ritorhymes ritorhymes changed the title Prepare Theme for Local Build Rendering [V2:01] Prepare Theme for Local Build Rendering May 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant