Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Empty file.
Empty file.
154 changes: 154 additions & 0 deletions exampleSite/content/blog/v0.11.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
---
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 your module reference:

```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 adds “System” with flash fix

## 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!
```

![Top Banner](https://github.com/user-attachments/assets/33a08c9b-db84-4200-b37c-1a53c1bef08d)

### Callouts Revamp

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

![Callout refresh](https://github.com/user-attachments/assets/b3154dbb-e582-4c84-a8b8-1ecb02c3464d)

### Analytics: Umami and Matomo

Built-in configuration for privacy-friendly analytics providers.

```yaml {filename="hugo.yaml"}
params:
analytics:
umami:
enable: true
websiteId: "YOUR_WEBSITE_ID"
src: "https://umami.example.com/script.js"
matomo:
enable: true
siteId: "1"
trackerUrl: "https://matomo.example.com/"
```

### Asciinema Shortcode

Embed terminal recordings from Asciinema using a simple shortcode.

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

![Asciinema](https://github.com/user-attachments/assets/3c33a8ef-3c01-4e30-9832-3ccb784ec538)


### Navbar Enhancements

- Support icon for links items in navbar
- Fix menu positions to play nicely with the language switcher and other items.

![Navbar with icon item](https://github.com/user-attachments/assets/6c035eee-cd7d-44d8-bcf7-9cbd7f92ab42)


### 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 that are neither docs nor blog posts for better context and navigation.

```yaml {filename="content/docs/guide/organize-files.md"}
---
breadcrumbs: false
title: Organize Files
---
```


### Cards and Badges Improvements

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

```yaml {filename="frontmatter"}
cards:
- title: "Guide"
tag: "New"
tagIcon: "sparkles"
tagBorder: true
```

![TODO: Cards and badges screenshot](#)

## Quality of Life

- Theme toggle: add “System” option and fix light/dark initial flash
- Typography: better task list styles with checkboxes
- Language switcher: improved ordering with icon menu items

![TODO: Theme toggle screenshot](#)
![TODO: Task list styles screenshot](#)

## 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
1 change: 1 addition & 0 deletions exampleSite/content/blog/v0.11.zh-cn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

7 changes: 7 additions & 0 deletions exampleSite/content/docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,10 +102,17 @@ To update Hextra to the [latest released version](https://github.com/imfing/hext
hugo mod get -u github.com/imfing/hextra
```

If you want to try the most recent changes before the next release, update the module to the development branch directly (⚠️ may contain unstable/breaking changes):

```shell
hugo mod get -u github.com/imfing/hextra@main
```

See [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/#update-all-modules) for more details.

{{% /details %}}


### Setup Hextra as Git submodule

#### Prerequisites
Expand Down
4 changes: 3 additions & 1 deletion exampleSite/hugo.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,9 @@ params:
externalLinkDecoration: true

banner:
key: 'announcement-v0_10'
key: 'announcement-v0.11'
message: |
Hextra **v0.11** is here! 🎉 Discover [what's new]({{< relref `blog/v0.11` >}})

navbar:
displayTitle: true
Expand Down
1 change: 1 addition & 0 deletions exampleSite/hugo_stats.json
Original file line number Diff line number Diff line change
Expand Up @@ -564,6 +564,7 @@
"hx:px-3",
"hx:px-4",
"hx:px-6",
"hx:px-8",
"hx:py-1",
"hx:py-1.5",
"hx:py-12",
Expand Down
3 changes: 0 additions & 3 deletions exampleSite/layouts/_partials/custom/banner.html

This file was deleted.