v0.147.0

This release comes with a new aligny option (shoutout to @pranshugaba for the implementation) for images.Text that, in combination with alignx makes it simple to e.g. center the text on top of image in both axis. But the main reason this release comes now and not later, is the improvements/fixes to the order Hugo applies the default configuration to some keys. This is inherited from how we did this before we rewrote the configuration handling, and it made the merging of configuration from modules/themes into the config root harder and less flexible than it had to be. Me, @bep, looking into this, was triggered by this forum topic. Having many sites share a common configuration is very useful. With this release, you can simply get what the thread starter asks for by doing something à la:

baseURL = "http://example.org"
title = "My Hugo Site"

# ... import any themes/modules.

# This will merge in all config imported from imported modules. 
_merge = "deep"

See the documentation for details.

Bug fixes

• tpl: Fix it so we always prefer internal codeblock rendering over render-codeblock-foo.html and similar 07983e0 @bep #13651
• tpl/tplimpl: Fix allowFullScreen option in Vimeo and YouTube shortcodes 5c49140 @jmooring #13650
• config: Fix _merge issue when key doesn't exist on the left side 179aea1 @bep #13643 #13646
• all: Fix typos 6a0e042 @coliff

Improvements

• create/skeletons: Adjust template names in theme skeleton 75b219d @jmooring
• tpl: Remove some unreached code branches ad4f63c @bep
• images: Add some test cases for aligny on images.Text 5320231 @bep #13414
• images: Add option for vertical alignment to images.Text 2fce0ba @pranshugaba

Dependency Updates

• build(deps): bump github.com/evanw/esbuild from 0.25.2 to 0.25.3 1bd7ac7 @dependabot[bot]
• build(deps): bump github.com/alecthomas/chroma/v2 from 2.16.0 to 2.17.0 41cb880 @dependabot[bot]

v0.146.7

Bug fixes

• Revert the breaking change from 0.146.0 with dots in content filenames 4967308 @bep #13632
• tpl: Fix indeterminate template lookup with templates with and without lang 6d69dc8 @bep #13636
• tpl/collections: Fix where ... not in with empty slice 4eb0e42 @bep #13621
• tpl: Fix layout fall back logic when layout is set in front matter but not found 5e62cc6 @bep #13630

Improvements

• parser/metadecoders: Add CSV targetType (map or slice) option to transform.Unmarshal db72a1f @jmooring #8859
• tpl: Detect and fail on infinite template recursion 1408c15 @bep #13627

Dependency Updates

• build(deps): bump github.com/yuin/goldmark-emoji from 1.0.5 to 1.0.6 ad78761 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.11.0 to 0.12.0 9c65b9e @dependabot[bot]
• build(deps): bump github.com/yuin/goldmark from 1.7.9 to 1.7.10 be3b147 @dependabot[bot]

v0.146.6

What's Changed

• tpl: Fix when layout specified in front matter and no match is found 088cd2f @bep #13628

v0.146.5

What's Changed

• build(deps): bump github.com/yuin/goldmark from 1.7.8 to 1.7.9 64cf008 @dependabot[bot]
• tpl: Fix language handling in partials d61b9fc @bep #13612

v0.146.4

What's Changed

• tpl: Fix issue with partials without suffix 65c94c7 @bep #13601
• tpl: Avoid panic on nonsensical return construct e8e8ce1 @bep #13600
• tpl: Fix the case for a shortcode in a nested folder only cf9e690 @bep #13605
• tpl: Add proper file context to template parse errors 8a2830f @bep #13604
• tpl: Make {{ template "partials/foo.html" . }} work in older setups 1e0287f @bep #13599

v0.146.3

What's Changed

• tpl: Make any layout set in front matter higher priority 30b9c19 @bep #13588
• tpl: Fix it so embedded render-codeblock-goat is used even if custom render-codeblock exists c871062 @bep #13595

v0.146.2

What's Changed

• tpl: Fix codeblock hook resolve issue d1c3944 @bep #13593
• tpl: Fix legacy section mappings 1074e01 @bep #13584
• tpl: Resolve layouts/all.html for all html output formats c19f1f2 @bep #13587
• tpl: Fix some baseof lookup issues 9221cbc @bep #13583

v0.146.1

This fixes a regression introduced in v0.146.0 released earlier today.

• tpl: Skip dot and temp files inside /layouts 3b9f2a7 @bep #13579

v0.146.0

Note

There's a v0.146.1 bug fix release that fixes a regression introduced in this release.

The big new thing in this release is a fully refreshed template system – simpler and much better. We're working on the updated documentation for this, but see this issue for some more information. We have gone to great lengths to make this as backwards compatible as possible, but make sure you test your site before going live with this new version. This version also comes with a full dependency refresh and some useful new template funcs:

• templates.Current: Info about the current executing template and its call stack. Very useful for debugging.
• time.In: Returns the given date/time as represented in the specified IANA time zone.

Bug fixes

• tpl/tplimpl: Fix full screen option in vimeo and youtube shortcodes 6f14dbe @jmooring #13531

Improvements

• tpl: Warn and skip non-hook templates inside /layouts/_markup 383dd82 @bep #13577
• tpl: Add a partial lookup cache 208a0de @bep #13571
• tpl: Add templates.Current d4c6dd1 @bep #13571
• commands/new: Improve theme creation 24ac6a9 @jmooring #13489 #13544
• tpl/tplimpl: Update embedded pagination template 1e00842 @jmooring
• Reimplement and simplify Hugo's template system 83cfdd7 @bep #13541 #13545 #13515 #7964 #13365 #12988 #4891
• config: Use the non-global logger for deprecations when possible 812ea0b @bep
• tpl/time: Add time.In function 07cbe57 @jmooring #13548
• resources: Add option to silence dependency deprecation warnings c15ebce @jmooring #13530
• common/hreflect: Replace the map/RWMutex method cache with sync.Map 8d2379b @bep
• common/hexec: Remove github.com/cli/safeexec a6bd677 @jmooring #13516
• parser/metadecoder: Improve errors for non-map XML root values f34cdc3 @thevilledev
• identity: Use clear to clear the finder seen map 52561d5 @bep
• cache: Apply httpcache defaults for polling config d28c84a @khayyamsaleem #13471
• tpl/tplimpl: Add loading attribute to Vimeo shortcode b9add1c @jmooring #13445
• commands: Add --omitEmpty flag to gen chromastyles 93df176 @jmooring #13475
• tpl: Add trailing newline to robots.txt template eebea9e @willfaught
• commands: Skip flaky test on Windows 3f2e1c0 @bep #13465
• resources/image: Mark loong64 as FMA-using architecture 3a11d22 @hannesbraun

Dependency Updates

• build(deps): bump github.com/fsnotify/fsnotify from 1.8.0 to 1.9.0 18d2d2f @dependabot[bot]
• build(deps): bump golang.org/x/tools from 0.31.0 to 0.32.0 cd3e349 @dependabot[bot]
• build(deps): bump github.com/evanw/esbuild from 0.25.1 to 0.25.2 8cd799a @dependabot[bot]
• build(deps): bump golang.org/x/image from 0.25.0 to 0.26.0 af0602c @dependabot[bot]
• build(deps): bump github.com/pelletier/go-toml/v2 from 2.2.3 to 2.2.4 650fe6c @dependabot[bot]
• build(deps): bump github.com/alecthomas/chroma/v2 from 2.15.0 to 2.16.0 d63491b @dependabot[bot]
• build(deps): bump golang.org/x/net from 0.37.0 to 0.39.0 e6e18e9 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.10.0 to 0.11.0 43af3bc @dependabot[bot]
• deps: Upgrade github.com/gohugoio/hugo-goldmark-extensions/passthrough v0.3.0 => v0.3.1 10b5543 @jmooring
• build(deps): bump golang.org/x/tools from 0.30.0 to 0.31.0 26d986f @dependabot[bot]
• build(deps): bump github.com/getkin/kin-openapi from 0.129.0 to 0.131.0 ebc0693 @dependabot[bot]
• build(deps): bump github.com/spf13/afero from 1.11.0 to 1.14.0 7ca6bb0 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.9.0 to 0.10.0 bddd2f9 @dependabot[bot]
• build(deps): bump github.com/golang-jwt/jwt/v5 from 5.2.1 to 5.2.2 1c69135 @dependabot[bot]
• build(deps): bump github.com/evanw/esbuild from 0.24.2 to 0.25.1 17db4ed @dependabot[bot]
• build(deps): bump github.com/bep/godartsass/v2 from 2.4.0 to 2.4.1 3968f91 @dependabot[bot]
• build(deps): bump golang.org/x/net from 0.35.0 to 0.37.0 e9bd237 @dependabot[bot]
• build(deps): bump github.com/bep/godartsass/v2 from 2.3.2 to 2.4.0 f4f21f5 @dependabot[bot]
• build(deps): bump golang.org/x/image from 0.24.0 to 0.25.0 61c39ae @dependabot[bot]
• deps: Upgrade golang.org/x/mod v0.23.0 => v0.24.0 2037137 @bep #13484
• build(deps): bump github.com/bep/overlayfs from 0.9.2 to 0.10.0 d78d4cf @dependabot[bot]
• build(deps): bump github.com/bep/lazycache from 0.7.0 to 0.8.0 f9aae15 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.8.4 to 0.9.0 b068671 @dependabot[bot]
• build(deps): bump github.com/bep/simplecobra from 0.5.0 to 0.6.0 93d9c05 @dependabot[bot]

Documentation

• commands/gen: Set url in command pages to /docs/reference/commands/ a98ec3b @jmooring

v0.145.0

The notable new feature is the new transform.PortableText function that makes it possible to use the Sanity CMS with Hugo.

Bug fixes

• all: Typo fixes 4094a1e @coliff
• all: Run modernize -fix ./... 521911a @bep
• readme: Fix relative links in Editions section ab9e545 @martey
• Fix some related content issues with content adapters 381c0da @bep #13443
• Fix potential nilpointer in httpcache config 227e429 @bep
• Fix --printPathWarnings when site calls templates.Defer c3d435a @bep #13420

Improvements

• Use the page path and not the backing filename as the last resort in the default sort c498d0f @bep
• tpl: HTTPS the instagram Shortcode JS 2f4e666 @coliff
• Add transform.PortableText 04f21b4 @bep
• hugolib: Deprecate _build front matter key in favor of build d0ce942 @jmooring

Dependency Updates

• deps: Upgrade github.com/rogpeppe/go-internal v1.13.1 => v1.14.1 6927e6f @bep #13449
• build(deps): bump github.com/yuin/goldmark-emoji from 1.0.4 to 1.0.5 b7ae24b @dependabot[bot]
• build(deps): bump github.com/google/go-cmp from 0.6.0 to 0.7.0 1a4851f @dependabot[bot]
• build(deps): bump github.com/tetratelabs/wazero from 1.8.2 to 1.9.0 d1f2330 @dependabot[bot]

Documentation

• github: Build docker image with both extended and withdeploy tags e5eecbd @margau

Build Setup

• snap: Update Node.js to 22.x 4fd7f32 @jmooring