drowl87/hextra_mirror
1
0
Fork 1
mirror of https://github.com/imfing/hextra.git synced 2025-09-14 10:46:47 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
Files
ccb63d60f1961739563e8e043c8bef433b3eee49
hextra_mirror/docs/content/blog/v0.11.md
Xin 83f3b5052e chore(docs): rename exampleSite to docs and create examples (#813) 
* chore(docs): rename `exampleSite` to `docs` and create `examples`

* chore(build): update build script to support new version format and source directories; add v0.10 to documentation menu
2025-09-06 12:06:26 +01:00

3.8 KiB
Raw Blame History

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.

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]({{% 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