Hextra v0.11

Hextra v0.11.0 focuses on UX polish and useful new components: site-wide banner, improved callouts and badges, richer cards, analytics integrations, and several navigation refinements. It also ships stability fixes and documentation updates.

Upgrade Guide

No breaking changes are expected for most sites. Update using Hugo Modules:

hugo mod get -u github.com/imfing/hextra

Highlights

• Top banner component for announcements
• Revamped callouts with clearer styles
• Umami and Matomo analytics support
• Asciinema shortcode for terminal recordings
• External link decoration option
• Breadcrumbs for single pages (non-docs, non-blogs)
• Navbar enhancements: icon link item and improved positions
• Improved badges and cards customization
• Theme toggle supports “System”

New Features

Top Banner

Add a site-wide, dismissible banner for announcements, launches, or status messages.

params:
  banner:
    key: "announcement"
    message: Welcome!

Callout Revamp

Callout receive a design refresh for better readability and emphasis across themes.

Analytics: Umami and Matomo

Built-in configuration for analytics providers:

• Umami
• Matomo

Asciinema Shortcode

Embed terminal recordings from Asciinema using the new Asciinema shortcode.

{{< asciinema id="123456" autoplay=true loop=true >}}

Navbar Enhancements

• Support icons for link items in the navbar
• Refine menu positions to play nicely with the language switcher and other items

Notably, version 0.10.2 enables the addition of language switchers and theme toggles to the navbar.

External Link Decoration

Optionally add a subtle external-link decoration to outbound links.

params:
  externalLinkDecoration: true

Breadcrumbs Enablement

Enable breadcrumbs on single pages (non-docs, non-blogs) by setting breadcrumbs: true in front matter.

---
title: About
breadcrumbs: true
---

Cards and Badges Improvements

• Cards: new tagIcon and tagBorder options.
• Badges: new colors and border styles.

Quality of Life

• Theme toggle: add “System” option
• Typography: better task list styles with checkboxes
• Language switcher: improved ordering with icon menu items

Fixes

• Giscus: sync theme and language properly
• Cards: fix badge rendering with RTL
• Navbar: refine menu positions and interactions

Documentation & i18n

• Docs: new page covering Hextra shortcodes
• i18n: add copyCode and system translations to zh-cn

Full Changelog: https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0