Files
hextra_mirror/exampleSite/content/blog/v0.11.md
Xin 6d0e59b16f chore: release blog for Hextra v0.11 (#806)
* feat: release Hextra v0.11 with new features and improvements

- Updated banner key to 'announcement-v0.11' with a new message.
- Added new padding option 'hx:px-8' in hugo_stats.json.
- Introduced new blog post for Hextra v0.11 detailing UX enhancements, new components, and stability fixes.
- Added translations for the new blog post in French, Japanese, and Simplified Chinese.
- Updated getting started documentation to include instructions for using the development branch.
- Removed outdated banner HTML for v0.10.

* feat: update language banners for Hextra v0.11 release

- Added localized banner messages for Persian, Japanese, and Simplified Chinese.
- Updated the main announcement message format in the configuration file.

* Update exampleSite/content/blog/v0.11.md

Co-authored-by: Ludovic Fernandez <ldez@users.noreply.github.com>

* Update exampleSite/content/blog/v0.11.md

Co-authored-by: Ludovic Fernandez <ldez@users.noreply.github.com>

* Update blog post for Hextra v0.11 release

- Refined upgrade guide and removed unnecessary breaking change note.
- Enhanced descriptions for new features including the top banner, callouts, and analytics configuration.
- Improved clarity in code examples and added links to documentation for new components.
- Updated navbar enhancements and breadcrumbs enablement instructions.
- Fixed formatting inconsistencies and improved overall readability.

* Add blog post for Hextra v0.11 in Persian, Japanese, and Simplified Chinese

- Introduced new features including a site-wide top banner, redesigned callouts, and analytics support for Umami and Matomo.
- Enhanced navigation with icon support and improved layout.
- Added Asciinema shortcode for terminal recordings and external link decoration options.
- Updated upgrade guide and documentation for new components.
- Included stability fixes and quality of life improvements.

---------

Co-authored-by: Ludovic Fernandez <ldez@users.noreply.github.com>
2025-08-30 13:48:04 +01:00

3.8 KiB

title, date, authors, tags
title date authors tags
Hextra v0.11 2025-08-30
name link image
imfing https://github.com/imfing https://github.com/imfing.png
Release

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!

Top Banner

Callout Revamp

[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) receive a design refresh for better readability and emphasis across themes.

Callout refresh

Analytics: Umami and Matomo

Built-in configuration for analytics providers:

  • [Umami]({{% relref "docs/guide/configuration.md#umami-analytics" %}})
  • [Matomo]({{% relref "docs/guide/configuration.md#matomo-analytics" %}})

Asciinema Shortcode

Embed terminal recordings from Asciinema using the new [Asciinema shortcode]({{% relref "docs/guide/shortcodes/asciinema.md" %}}).

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

Asciinema

Navbar Enhancements

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

Navbar with icon item

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

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]({{% relref "docs/guide/shortcodes/cards.md" %}}): new tagIcon and tagBorder options.
  • [Badges]({{% relref "docs/guide/shortcodes/others.md" %}}): new colors and border styles.

Quality of Life

  • Theme toggle: add "System" option Theme toggle
  • Typography: better task list styles with checkboxes Task list
  • 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