v2.0.0 — Zola 0.22+ with giallo syntax highlighting

v2.0.0

Breaking change: Requires Zola >= 0.22. Users on older Zola versions should use v1.0.0.

What's new

• Giallo syntax highlighting — Replaces syntect with giallo, Zola 0.22's new highlighting engine. Theme switching uses media attribute toggling for cleaner light/dark support.
• Recommended Zola defaults — External links open in new tabs with rel="noopener noreferrer external", lazy image loading, GitHub-style alerts (> [!NOTE], etc.), and error_on_missing_language to catch typos in code fences.
• New light syntax theme — everforest-light replaces gruvbox-dark-medium as the light mode theme.
• Nav link layout fix — Flexbox layout prevents nav links from collapsing.

Migration from v1.0.0

1. Update Zola to >= 0.22

2. Replace your [markdown] config:

   - [markdown]
   - highlight_code = true
   - highlight_theme = "css"
   - highlight_themes_css = [
   -   { theme = "one-dark", filename = "syntax/syntax-theme-dark.css" },
   -   { theme = "gruvbox-dark", filename = "syntax/syntax-theme-light.css" },
   - ]
   + [markdown.highlighting]
   + style = "class"
   + dark_theme = "material-theme-palenight"
   + light_theme = "everforest-light"

3. Delete static/syntax/ (old syntect CSS files)

4. Run zola build to generate the new giallo CSS

Removed

• static/syntax/syntax-theme-dark.css and syntax-theme-light.css (syntect)
• static/js/reference-return.js (now handled natively by Zola's bottom_footnotes)

v1.0.0 — Last release for Zola <0.22

v1.0.0

This release marks the last version of radion compatible with Zola versions prior to 0.22 (0.20.0–0.21.x).

Highlights

• Class-based syntax highlighting via syntect (highlight_theme = "css")
• Light/dark mode with toggle support
• Search bar with ElasticLunr
• LaTeX/MathJax support
• Giscus comment integration
• Custom fonts (Google Fonts, Fontsource, ZeoSeven, custom CSS)
• Code block copy-to-clipboard with language labels
• Table of contents, footnotes, Open Graph metadata, and more

For users on Zola <0.22

Add the theme at this tag in your project:

git submodule add -b main https://github.com/micahkepe/radion.git themes/radion
cd themes/radion
git checkout v1.0.0

Going forward

Future development on main targets Zola ≥0.22, which introduces breaking changes to syntax highlighting (giallo replaces syntect). See #47 for details.