This release brings a rewrite of the logic around browser refreshes when running hugo server. We have seen some situations where asset changes (e.g. image/CSS/JS) has not been refreshed reliably in all browsers, even with the developer console open and the cache disabled. We suspect this comes from a recent browser bug (typically: Works fine in Safari, does not refresh in Chrome). The strategy we've been using when a change triggers multiple changes (e.g. both HTML and CSS) is to do one "browser force refresh", which in LiveReload ends up as a window.location.reload(). With this release we:

1. Are more specific about what we refresh, but fall back to "force refresh" for bigger change sets.
2. INFO log exactly what we do in these situations with the prefix livereload.

Start the server with:

hugo server --logLevel info

And you should see how Hugo handles browser updates when you change content/templates etc.

A related tip; start the server with

hugo server --logLevel info -N

Hugo will navigate to the content file you're changing and log it in the console.

Also new in this release a new xxHash hashing function that is much faster than any of the other hashing functions in Hugo, especially for larger inputs.

Note

We have upgraded the integration with Git used to load GitInfo to be part of Hugo's Security Policy. We have added git to the default whitelist, but if you have a custom security policy, you may have to update that.

Bug fixes

• commands: Fix --navigateToChanged server behavior when editing headless content cc2d19e @bep #12648
• commands: Fix hugo mod get -u ./... 251a23e @bep #12625

Improvements

• tpl: Use xxHash instead of MD5 to hash the deferred templates 4d8bfa7 @bep
• Throw error if resources.PostProcess is used in a deferred template f0ed91c @bep #12655
• commands: Simplify the browser live reload logic 094f746 @bep #12643
• Use xxHash for the change detector fb8909d @bep #12643
• source: Expose GitInfo Body 0ee2610 @PeskyPotato #10905
• Add hash.XxHash 644d554 @bep #12635

Dependency Updates

• deps: Upgrade github.com/bep/gitmap v1.4.0 => v1.6.0 (note) 7be0377 @bep #8627
• deps: Go mod tidy 439f07e @bep
• deps: Upgraded github.com/tdewolff/minify/v2 v2.20.20 => v2.20.36 ce5a2ce @bep
• deps: Upgrade to golang.org/x/image v0.18.0 0f42d97 @bep

What's Changed

• Fix site.GetPage, never do short lookups for paths with leadig slash 8cf96f2 @bep #12638

What's Changed

• Fix it so publishDate rolls up to section, taxonomy, or term pages 7b6dafc @bep #12438
• create/skeletons: Fix languageCode region subtag a95fe50 @CyrusYip
• Update README.md 932ab4c @jmooring

This release brings TailwindCSS v4 (alpha) support. For more info about the TailwindCSS 4 integration, see this repo. Also notable is the new templates.Defer template func and the dramatically improved performance of $page.GetTerms for bigger sites.

Bug fixes

• tpl/debug: Fix reset of debug timers when running the server c880faa @bep #12621
• Fix Erroridf/Warnidf mixed case issue 8731d88 @bep #12617
• Fix live reload when both CSS and HTML changes ad6d91c @bep #12600
• config: Fix typo 7ee36b3 @razonyang

Improvements

• Add css.TailwindCSS e1317dd @bep #12618 #12620
• Clean up the css related template funcs package structure eddcd2b @bep #12618
• modules: Remove newly introduced "mount source" does not exist warning 16e4662 @bep
• Implement defer 6cd0784 @bep #8086 #12589
• common/hexec: Fall back to the binary in PATH if npx fails 1c85830 @bep #12486
• deploy: Add stripIndexHtml target option d5542ed @depp #12607
• Speed up GetTerms 478a910 @bep #12610
• markup/goldmark: Add the Hugo Goldmark Extras "delete" extension 8efc75b @jmooring #12597
• resources: Update Dart Sass error message 57165d4 @jmooring
• resources/page: Deprecate PageSize in favor of PagerSize 9c3143c @bep #12572
• Rename DefaultPageSize => PagerSize 9f22bc4 @bep
• resources/page: Let GroupByParam return nil instead of error cba2de6 @jmooring #12578
• Add option to not generate aliases for first page of pagination pages 9c4e14e @bep #12572
• js: Support more recent targets with js.Build / esbuild 1cdd3d0 @bep #12575

Dependency Updates

• deps: Upgrade github.com/yuin/goldmark v1.7.2 => v1.7.4 79da24a @jmooring
• deps: Upgrade github.com/yuin/goldmark-emoji v1.0.2 => v1.0.3 b187c06 @jmooring
• deps: Upgrade github.com/alecthomas/chroma v2.13.0 => v2.14.0 8cf94ae @jmooring #12580
• deps: Upgrade github.com/evanw/esbuild v0.20.2 => v0.21.4 b57306d @bep #12575

Build Setup

• Delete unused release hook script 1687a9a @bep #12378

Documentation

• Update README.md 3b72446 @bep
• Update README.md b46d101 @bep

This release brings proper HTTP caching and live reloading of remote resources fetched with resources.GetRemote, especially useful when used with content adapters.

Note that this isn't enabled out of the box, so if you need this, you need to add some configuration. The demo below is configured as:

[httpcache]
[httpcache.cache]
[httpcache.cache.for]
includes = ['https://sheets.googleapis.com/**']
[[httpcache.polls]]
low  = '1s'
high = '30s'
[httpcache.polls.for]
includes = ['https://sheets.googleapis.com/**']

What's Changed

• Add a HTTP cache for and polling configuration for remote resources. 447108f @bep #12502 #11891
• Misc remote HTTP/content adapter enhancements 2b05a50 @bep #12502 #12570

• content adapter: Fix site.GetPage using the base part of the path 917199a @bep #12561
• resources/page: Deprecate .Sites.First in favor of .Sites.Default c8dac67 @jmooring #12513
• metrics: Increase maximum length of cumulative duration to 15 0068f03 @razonyang
• content adapter: Handle more separator in content.value 0221ddb @bep #12556

Bug fixes

• content adapter: Fix server crash on partial edit 1464091 @bep #12538
• content adapter: Fix issue with content starting out with a shortcode 519f41d @bep #12544
• tpl/tplimpl: Resolve render hook destinations with leading ./ b893a09 @jmooring #12514

Improvements

• Delete .github/workflows/test-dart-sass-v1.yml 2c88e45 @bep
• commands: Add shorthand flags -M (--renderToMemory) and -N (--navigateToChanged) eaa42a8 @bep #12530
• content adapter: Add support for menus in AddPage 245928a @bep #12507
• hugolib: Allow override of sitemap file name 7f30617 @jmooring #12525
• commands: Improve list command 931e096 @jmooring #12520
• config: Remove extraneous BuildConfig setting 548dc21 @jmooring #12519
• Also warn about duplicate content paths with --printPathWarnings 6b00661 @bep #12511

What's Changed

• Fix mixed case Page params handling in content adapters 39cf906 @bep #12497
• Fix paths with dots issue with content adapters 1aacfce @bep #12493

This release brings, drum roll, a long-awaited Hugo feature that has had many names. At one point we named it pages from data. You can read all about it in the documentation where it's titled Content Adapters.

Also worth mentioning are the new Extras Goldmark Extensions, which allows you to enable Markdown syntax for inserted text, mark text, subscript and superscript. A big thanks to @bowman2001 for the implementation.

Improvements

• tpl/tplimpl: Plainify title and description in twitter_cards.html 74ab839 @jmooring #12433
• tpl/tplimpl: Plainify title and description in schema.html 92290aa @jmooring #12432
• resources/images: Handle NaN EXIF latitude and longitude 6dbbe6d @jmooring #12490
• Create pages from _content.gotmpl e2d66e3 @bep #12427 #12485 #6310 #5074
• create/skeletons: Remove superfluous language code fallback 55dea41 @jmooring #12479
• tpl/tplimpl: Improve locale value in opengraph.html 87ab7f7 @jmooring #12480
• tpl/tplimpl: Retain query string and fragment in render-image.html 6dfeb9f @jmooring #12468
• markup/goldmark: Support extras extension ca9a77e @jmooring

Dependency Updates

• build(deps): bump golang.org/x/net from 0.24.0 to 0.25.0 ee26e69 @dependabot[bot]
• build(deps): bump golang.org/x/image from 0.15.0 to 0.16.0 6e83d00 @dependabot[bot]

Documentation

• docs: Regen docshelper 2661402 @bep

Build Setup

• livereload: Improve the livereload script build and update to v4.0.2 d02f062 @bep #12451 #6290

Note that this release is only relevant if you use Hugo's openapi3.Unmarshal template function.

What's Changed

• deps: Downgrade github.com/getkin/kin-openapi v0.124.0 => v0.123.0 3c6260f @bep