mirror of
https://github.com/imfing/hextra.git
synced 2025-10-31 10:14:52 -04:00
83f3b5052e
* 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
129 lines
3.8 KiB
Markdown
129 lines
3.8 KiB
Markdown
---
|
|
title: "Hextra v0.11"
|
|
date: 2025-08-30
|
|
authors:
|
|
- name: imfing
|
|
link: https://github.com/imfing
|
|
image: https://github.com/imfing.png
|
|
tags:
|
|
- 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.
|
|
|
|
<!--more-->
|
|
|
|
## Upgrade Guide
|
|
|
|
No breaking changes are expected for most sites. Update using [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/):
|
|
|
|
```bash
|
|
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.
|
|
|
|
```yaml {filename="hugo.yaml"}
|
|
params:
|
|
banner:
|
|
key: "announcement"
|
|
message: Welcome!
|
|
```
|
|
|
|
|
|
|
|
### Callout Revamp
|
|
|
|
[Callout]({{% relref "docs/guide/shortcodes/callout" %}}) receive a design refresh for better readability and emphasis across themes.
|
|
|
|
|
|
|
|
### 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](https://www.asciinema.org/) using the new [Asciinema shortcode]({{% relref "docs/guide/shortcodes/asciinema.md" %}}).
|
|
|
|
```md
|
|
{{</* 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](https://github.com/imfing/hextra/releases/tag/v0.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.
|
|
|
|
```yaml {filename="hugo.yaml"}
|
|
params:
|
|
externalLinkDecoration: true
|
|
```
|
|
|
|
### Breadcrumbs Enablement
|
|
|
|
Enable breadcrumbs on single pages (non-docs, non-blogs) by setting `breadcrumbs: true` in front matter.
|
|
|
|
```yaml {filename="content/about.md"}
|
|
---
|
|
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
|
|
|
|
- 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
|