Skip to content

Compatibility with Zola 0.22.x: highlighting config error and jinja2 language issue #34

@danielezambelli

Description

@danielezambelli

Hello,

I'm trying to use this great theme with the latest version of Zola (0.22.1), but I'm running into compatibility issues with the new "Giallo" syntax highlighting system.

Environment:

Zola version: 0.22.1

Theme: Latest commit ecbb7a0 (Jan 9, 2026)

OS: Debian Testing

Issue 1: Highlighting configuration
According to the Zola 0.22.0 changelog, the new syntax for highlighting is:
toml

[markdown.highlighting]
theme = "github-light"
error_on_missing_language = true

But when I add this configuration, Zola fails with:
text

ERROR TOML parse error ... data did not match any variant of untagged enum HighlightConfig

It seems the theme still expects the old syntax and is not fully compatible with the new one.

Issue 2: jinja2 language not recognized
With the old syntax (or by disabling highlighting) the site builds correctly. However, when I try to use the new configuration that treats missing languages as errors, Zola stops at:
text

ERROR Reason: Language jinja2 not found for syntax highlighting in "templates/robots.md".

The theme's example files use the jinja2 label, which is not among the languages supported by default in Giallo.

Questions:

Are there any plans to update the theme to support Zola 0.22.x syntax?

In the meantime, what is the recommended configuration to make the theme work with Zola 0.22.1?

For the example files, should I replace the jinja2 label with htmldjango or just remove it?

Thank you for your attention and great work on this theme!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions