Skip to content

Update to zola 0.22.1#2425

Draft
ChristopherBiscardi wants to merge 1 commit intobevyengine:mainfrom
ChristopherBiscardi:zola-upgrade
Draft

Update to zola 0.22.1#2425
ChristopherBiscardi wants to merge 1 commit intobevyengine:mainfrom
ChristopherBiscardi:zola-upgrade

Conversation

@ChristopherBiscardi
Copy link
Copy Markdown
Contributor

Important

This is currently not mergable as the new zola syntax highlighting means our custom CSS overrides are not applied.

side-by-side of ron/rust/wgsl examples on the site Screenshot 2026-04-06 at 5 31 51 PM Screenshot 2026-04-06 at 5 31 58 PM Screenshot 2026-04-06 at 5 34 50 PM

Notably, zola has produced their own code highlighting solution that in the future causes us to need to write our custom .css syntax theme as a vscode theme instead. However, as far as I can tell, this is not possible until zola releases a new version. The current state is that the CSS overrides we use aren't applied as they were previously when using zola's new giallo.

Notably, zola has produced their own code highlighting solution that in the future causes us to need to write our custom .css syntax theme as a vscode theme instead.
However, as far as I can tell, this is not possible until zola releases a new version.
The current state is that the CSS overrides we use aren't applied as they were previously when using zola's new giallo.

- zola built a replacement for syntect called giallo: getzola/zola#2758
- There are CSS fixes to code style generation that seem relevant but will fully break any attempt at the css class based highlighting that we have now: getzola/giallo#56
  > The current CSS generation in giallo is broken: getzola/giallo#56 will be included in the next Zola release.
  >
  > [keats](getzola/zola#3075 (comment))
- We will need to write our theme as a vscode theme to regain styling. I haven't explored actually writing this theme file yet so don't know if there will be regressions or opportunities for enhancements.
@ChristopherBiscardi
Copy link
Copy Markdown
Contributor Author

I'm also going to mention @Keats , since they commented on the relevant #2325 , just in case they're interested in the topic.

Our next steps are to explore writing the vscode theme file to regain our custom syntax highlighting.


however, the syntax highlighting is the only blocker we have for upgrading zola. There are no other issues as far as I can tell.

@Keats
Copy link
Copy Markdown
Contributor

Keats commented Apr 7, 2026

There are no other issues as far as I can tell.

Shouldn't be. 0.23 will have the biggest changes for the template engine but it's not out yet. Since it will contain the fix for giallo CSS though, it might be better to wait for it

@alice-i-cecile alice-i-cecile added C-Webdev S-Blocked X-Contentious There are nontrivial implications that should be thought through A-Meta labels Apr 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Meta C-Webdev S-Blocked X-Contentious There are nontrivial implications that should be thought through

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants