chore(deps): update dependency gohugoio/hugo to v0.112.5 #92

renovator · 2023-03-18T20:36:17Z

renovator commented

2023-03-18 20:36:17 +00:00

This PR contains the following updates:

Package	Update	Change
gohugoio/hugo	minor	`v0.105.0` -> `v0.112.5`

Release Notes

gohugoio/hugo

`v0.112.5`

Compare Source

What's Changed

Fix it so languageCode on top level config still works e3dfc76 @bep #11037

`v0.112.4`

Compare Source

Fix Processed images count regression for multiple languages fd09933 @bep #11002
Fix --renderStaticToDisk regression 8f293a1 @bep #11026
commands: Add the common build flags to the config commands 51d0a0a @bep #11018
commands: Reinstate some of the removed build flags (e.g. --theme) to new and mod 43f1282 @bep #11018
Don't create the public folder unless needed e96cdfe @bep #11031
commands: Fail the build when no config file or config dir 273d9f6 @bep #11019
langs: Remove the Language.Params deprecation message for now a6257d8 @bep #11025
Add language.LanguageCode 6c2db0d @bep #11027
commands: Re-introduce the -f shorthand for hugo new site 901cd97 @bep #11015
commands: Move the --format flag to only the commands that support it f86b5f7 @bep #11022

Documentation

docs: Regenerate CLI docs 20ea2e0 @bep
docs: Regen CLI docs ffdbce5 @bep

`v0.112.3`

Compare Source

What's Changed

Fix regression when loading config -e is empty or HUGO_ENV or HUGO_ENVIRONMENT is set 231374a @bep #11013

`v0.112.2`

Compare Source

What's Changed

minifiers: Make sure JS.Version always has a value dd67922 @bep #11012
Fix regression with site.IsServer when not running a server 9a235d0 @bep #11006

`v0.112.1`

Compare Source

What's Changed

Fix regression when config for OutputFormat.BaseName is an empty string ed906a8 @bep #11000

Also see the main release: https://github.com/gohugoio/hugo/releases/tag/v0.112.0

`v0.112.0`

Compare Source

Note: There's a patch release out already, see https://github.com/gohugoio/hugo/releases/tag/v0.112.1

Proper TailwindCSS v3.x support, much improved language config merge, consolidation of all Hugo config (check out hugo config), rewritten commands package (CLI) using SimpleCobra, Goldmark's typographer extension (quotation marks per language), and more.

Headlines

TailwindCSS v3.x Support, new cache buster configuration

See https://github.com/bep/hugo-starter-tailwind-basic for a running example.

TailwindCSS 3 has been out for a while now, and unfortunately their new build strategy didn't work very well with Hugo. But this release adds a new build.cachebusters config option for the resource cache that allows more fine grained control over when to trigger a new Tailwind build. This is a generally useful feature, so if you're having issues not seeing your resource changes (e.g. change to a JS file) on change, you could try to tweak the defaults. A tip is to run the server with hugo server --debug and watch out for log messages prefixed with cachebuster: on file changes.

There are several possible setups here, but one that we have tested and that works well is outlined in the config below. The basic concept is to add hugo_stats.json to the server watcher list in Hugo and trigger a new TailwindCSS build only whenever either this file or the main CSS file changes.

[module]
  [[module.mounts]]
    source = "assets"
    target = "assets"
  [[module.mounts]]
    source = "hugo_stats.json"
    target = "assets/watching/hugo_stats.json"

[build]
  writeStats = true
  [[build.cachebusters]]
    source = "assets/watching/hugo_stats\\.json"
    target = "styles\\.css"
  [[build.cachebusters]]
    source = "(postcss|tailwind)\\.config\\.js"
    target = "css"
  [[build.cachebusters]]
    source = "assets/.*\\.(js|ts|jsx|tsx)"
    target = "js"
  [[build.cachebusters]]
    source = "assets/.*\\.(.*)$"
    target = "$1"

And then in tailwind.config.js:

module.exports = {
	content: ['./hugo_stats.json'],
};

Reconsolidated all configuration handling

For this release we have collected all configuration into one big Go struct and rewritten the command line API using SimpleCobra. All of this makes the source code easier to maintain and understand, but the original motivation for this was to get a complete and autogenerated API reference for Hugo (we're working on getting that done), but this also have some less technical upsides:

'hugo config' is now complete

What you get when running hugo config is a complete TOML representation (add --format json or --format yaml for alternative formats) of the effective configuration. As this will include default values and configuration merged in from themes, we don't recommend to copy and paste this into hugo.toml, as that would make your configuration very verbose.

Improved language config handling

See issue #10620 for some details, but in general, the merge behaviour of sections from languages is much improved. In the example below for language en you will now get:

 "comments": {
    "color": "blue",
    "title": "English Comments Title",
}

In earlier versions of Hugo you would get:

 "comments": {
    "title": "English Comments Title",
}

title = "Base Title"
staticDir = "mystatic"
[params]
[params.comments]
color = "blue"
title = "Default Comments Title"
[languages]
[languages.en]
title = "English Title"
[languages.en.params.comments]
title = "English Comments Title"

Note that values in a given language will always have precedence over same keys in root (the section inside the language is the receiving side of any merge operation), so, if you want the old (and buggy) behaviour, you can add a merge strategy to one of the params sections, e.g:

[languages.en.params.comments]
_merge = "none"
title = "English Comments Title"

You can now also configure just about everything per language. One useful example would be the Goldmark typographer extension:

[languages.de]
languageCode = 'de-DE'
languageName = 'Deutsch'
weight = 2
[languages.de.markup.goldmark.extensions.typographer]
leftDoubleQuote = '&laquo;'   # default &ldquo;
rightDoubleQuote = '&raquo;'  # default &rdquo;

More info in verbose build output

If you build flag with the -v, you will now get timing info for the core building steps in Hugo:

INFO 2023/05/16 09:53:55 process in 17 ms
INFO 2023/05/16 09:53:55 assemble in 345 ms
INFO 2023/05/16 09:53:55 render in 341 ms
INFO 2023/05/16 09:53:55 postProcess in 0 ms

Notes

openapi2: .ExtensionProps is now .Extensions and just a map.
We have deprecated site.Language.Params and configuration of custom params outside of the language [params], see https://gohugo.io/content-management/multilingual/#changes-in-hugo-01120 for more information.

Bug fixes

Fix "unknown command" message when no suggestion 288be19 @bep #10953
commands: Fix build logic when listing expired/future draft content e6dc805 @bep #10972
commands: Fix data race 0a51dfa @bep #10953
tpl/urls: Fix build broken by a merge e4e0313 @bep
Fix warn message about custom params on the language top level ad4bc96 @deining
Fix some spelling mistakes 4003c79 @cuishuang
all: Fix comments for exported functions and packages 610ceda @alexandear
modules: Fix format flag in error 95818e2 @alexandear
Fix some recently introduced error handling issues 834b3d7 @bep #10953
Re-add site.LanguagePrefix 86b2a27 @bep #10947
Deprecate site.Language.Params and some other fixes 5d85716 @bep #10947
readme: Fix build command d01731d @kirisakow
resources: Fix typos in error message and variables 891b291 @alexandear
commands: Fix data race in test 0fbab7c @bep

Improvements

circleci: Add github.com to known hosts 70b2aaf @bep
Add --format to hugo config 85b13c1 @bep
postcss: Improve validation of option 'config' 9a0370e @deining
Avoid writing to hugo_stats.json when there are no changes 4cac5f5 @bep #10985
Add cache busting config to support Tailwind 3 2c3d4df @bep #10974
commands: Make all list commands list what 'all' did before 6ca8a40 @bep #10953
tpl/tplimpl: Add img loading attribute to figure shortcode (#10927) 2db7ec6 @InLaw
Allow whitelisting mediaTypes used in resources.GetRemote 2637b4e @bep #10286
Add hugo.WorkingDir 7c7baa6 @bep #10969
Make language merging of markup etc. config without values in the root 4f085e8 @bep #10953
tpl/urls: Return empty string when JoinPath has zero args 150d190 @jmooring
Re-add --printUnusedTemplates and --printPathWarnings d6197a4 @bep #10953
tpl/urls: Add JoinPath template function 5b3e165 @jmooring #9694
Allow legacy taxonomyTerm in disableKinds 03cb38e @bep #10953
Make GOMAXPROCS to be CPU limit aware 008170c @BenTheElder #10950
Allow empty params.mainSections 7c647bc @bep #10953
commands: Load config before creating the filesystem 3f00f47 @bep
github: Trim the test flow a little 35955f5 @bep
commands: Improve the common build flag handling 8a69ccb @bep #10947
Support, but warn, about top level language custom params 7ce033a @bep #10947
Handle transient errors in config loading etc. 0554213 @bep #10947
Re-establish all the server flags 5251f01 @bep #10947
Revert "Make GOMAXPROCS CPU limit aware" 0106cf1 @bep
Make GOMAXPROCS CPU limit aware 59050f9 @BenTheElder #10950
Add Sections to Site interface faa6998 @bep #10947
helpers: simplify path tests with T.TempDir 3d90871 @alexandear
tpl: Add math.Abs bda082c @alexandear #10941
Create a struct with all of Hugo's config options 241b21b @bep #10896 #10620
Improve date parsing performance for the common case 6aededf @bep #10942
Add a counter helper 0988b76 @bep
Expand the baseline benchmark a little e0e19a9 @bep
Revert "Update syntax-highlighting.md (#10929)" (#10930) bcd7ac7 @jmooring
Update syntax-highlighting.md (#10929) a4fb8dc @kirillbobyrev
tpl/strings: Clarify findRESubmatch description 5c7b79c @jmooring
langs/i18n: Fallback to defaultContentLanguage instead of English 0cb6ca5 @jmooring #9216
tpl/debug: Add VisualizeSpaces f106251 @bep
Prevent the global error collector to panic when sending on closed channel 9906c1a @bep
markup/goldmark: Add config options for the typographer extension 5596dc2 @bep #9772
Add test for ToC vs include 5748133 @bep #10866
resources.functions: improve validation 05c095a @deining
markup/goldmark: Fail on invalid Markdown attributes b0b1b76 @bep
tpl/math: Return error if less than 2 input numbers f5eddf8 @septs #10827

Dependency Updates

Revert "build(deps): bump gocloud.dev from 0.24.0 to 0.29.0" f014921 @bep #10993
build(deps): bump github.com/tdewolff/parse/v2 from 2.6.5 to 2.6.6 1292d5a @dependabot[bot]
build(deps): bump gocloud.dev from 0.24.0 to 0.29.0 baa5569 @dependabot[bot]
build(deps): bump github.com/gobuffalo/flect from 0.3.0 to 1.0.2 a5413c1 @dependabot[bot]
build(deps): bump golang.org/x/image from 0.5.0 to 0.7.0 9cea58a @dependabot[bot]
build(deps): bump github.com/tdewolff/minify/v2 from 2.12.4 to 2.12.5 1a5dce4 @dependabot[bot]
build(deps): bump github.com/dustin/go-humanize from 1.0.0 to 1.0.1 065ae00 @dependabot[bot]
build(deps): bump google.golang.org/api from 0.76.0 to 0.123.0 1a7d57c @dependabot[bot]
build(deps): bump golang.org/x/tools from 0.4.0 to 0.9.1 bba54e6 @dependabot[bot]
build(deps): bump github.com/cli/safeexec from 1.0.0 to 1.0.1 7370543 @dependabot[bot]
build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.117.0 f6269ee @dependabot[bot]
deps: Update github.com/evanw/esbuild v0.17.0 => v0.17.19 715d484 @bep
deps: Update github.com/alecthomas/chroma/v2 v2.7.0 c371171 @bep
deps: Update github.com/bep/golibsass v1.1.0 => v1.1.1 24e7d0c @bep #10629 #10491

Documentation

docs: Regen docshelper b6e6438 @bep
commands: Add missing gen docshelper command 943ff7f @bep #10953
docs: Regen CLI docs 10d0fcc @bep
tpl/lang: document delimiter option for FormatNumberCustom 1155bbc @jmooring
Update README.md 4f341fa @bep
Update README.md 46a3cf6 @bep
Update README.md f1e8f01 @bep

`v0.111.3`

Compare Source

Bug fixes

Fix "unknown shortcode token" when calling shortcode within fenced code block e7148f3 @bep #10819
Don't fail when calling Paginate with an empty pages.PagesGroup 34a86e1 @bep #10802
Improve error message for unclosed shortcode with inner content 9818724 @deining

Improvements

tpl: Add hasSuffix alias d171d15 @jfish2
Run gofmt -s on source files d55af2a @deining
tpl/math: Allow multi numbers in add, sub, mul, div, min and max 84201e8 @septs
server: Replace golang.org/x/net/context with context 0f01bd4 @alexandear
watcher: use time.NewTicker to prevent leaks 02ab77d @alexandear
ensure we default to 10 correctly 873be9f @davidejones
switch transfers to workers bebb2b8 @davidejones
customize parallel transfer count e6f029b @davidejones
metadecoders: Add support for native org dates in frontmatter PR #7433 added support for Org timestamps for the DATE header. This PR widens the support with additional front matter headers LASTMOD, PUBLISHDATE and EXPIRYDATE. bdbfacb @johannesengl #8536

Dependency Updates

deps: Update go-org to v1.6.6 1c841ec @niklasfasching

Documentation

docs: Improve examples of variadic math functions b6f44aa @jmooring
readme: Update dependency list 04b9811 @deining

`v0.111.2`

Compare Source

Bug fixes

Fix .Fragments when called cross sites on uninitialized output format b83050c @bep #10794
Fix "context canceled" with partial 3bbeb56 @bep #10789
cache: Fix --gc failure on Windows 184a67a @alexandear
snap: Fix dart-sass-embedded installation a950950 @jmooring #10783
Allow page.TableOfContents on self in shortcode df5608f @bep #10791
Page context handling in i18n 6c798eb @bep #10782
Work around --gc failure on Windows <= 10 ec1c97e @bep #10781
Correct typos in Go comments 36ce3a4 @alexandear

Documentation

tpl/partial: Consolidate GoDoc f56ce01 @bep

Build Setup

Update to Go 1.20.1 f10009e @bep #10785

`v0.111.1`

Compare Source

This fixes the "page" not defined issue in Hugo 0.111.0. eef23a7 @bep #10774

`v0.111.0`

Compare Source

Hugo 0.111.0 is the second Hugo release of the year. Note: There's already a patch release.

Notable news

Page Fragments

We added the new .Fragments method on Page as part of the Related Content feature refresh (below), but it's plenty useful on its own, and has been long sought after by Hugo users.

It has many uses: Build table of contents, check if a page fragment (heading identifier) exists on a page, check for duplicate heading identifiers, start table of contents from a specific heading identifier. See the Hugo Documentation for more information

We have reworked the Related Content API so it's now one method .Related that takes either a Page or an options map. We have also introduced a new type attribute on the index configuration with the new type fragments. See this for details, but to add some weight to the page titles in the Related Content configuration you can do this:

[related]
threshold    = 20
includeNewer = true
toLower      = false
[[related.indices]]
name        = "fragmentrefs"
type        = "fragments"
applyFilter = false
weight = 50

See the Hugo Documentation for more.

Global page func

Note: There was a bug in this release that made this new feature not working, so you need to upgrade to Hugo 0.111.1. We blame it on Go.

Hugo almost always passes a Page as the data context into the top level template (e.g. single.html) (the one exception is the multihost sitemap template). This means that you can access the current page with the . variable in the template.

But when you're deeply nested inside .Render, partial etc., accessing that Page object isn't always practical or possible.

For this reason, Hugo now provides a global page function that you can use to access the current page from anywhere in any template.

{{ page.Title }}

Notes

For the Goldmark markdown hander, we now split parse and render for Goldmark. This was motivated by the new fragments support in Related Content, but it has some other side effects: If you only need a page's table of contents, we now skip the rendering step, which makes it faster, but it also means that you can access the page .Fragments structure from everywhere, even in render hooks (271318a @bep #10750)
tpl/tplimpl: Remove the Google News internal template 66f94b4 @jmooring
Only invoke a given cached partial once 4ef9baf @bep #4086 #9588

Bug fixes

strings: fix Truncate behavior for formatted html c0d15a2 @khayyamsaleem #10399
Fix shortcode error when closing without .Inner ae48507 @bep #10672
create: Fix typo in error message 2dad13c @aaronhooper
resource_transformers/tocss: Fixed hugo:vars casting a1a9c08 @acclassic #10632
markup: Fix linenos codeblock hl option case regression 73ece30 @khayyamsaleem #10682
Fix slow HTML elements collector for the pre case f9fc0e0 @bep #10698
commands: Fix server url rewrites (http status 200) 1477d0b @bep #10668
Fix description of collections.Uniq 4ccc8cf @jmooring
Fix shortcode detection in RenderString 1688583 @bep #10654

Improvements

Replace deprecated ioutil with io and os d453c12 @alexandear
build: Bump build images 60e6fa7 @bep
build: Update Linux ARM build image 7e51ba0 @bep
tpl/tplimpl: Remove the Google News internal template 66f94b4 @jmooring
tpl/strings: Adjust benchmark 2a61910 @bep
tpl/strings: Add BenchmarkTruncate 079d1b6 @bep
Misc ioutil deprecation adjustments a669467 @bep #10732
Remove unused temp directory e314410 @alexandear
exif: Return the proper exposure time value in some special cases 39cc3a2 @WaltCuller #10738
Add a page template func ce524d0 @bep #9339
dartsass: Import CSS without extension at compile time 2662faf @jmooring #10592
Split parse and render for Goldmark 271318a @bep #10750
related: Add config option cardinalityThreshold e442a63 @bep #10744
Throw an error when shortcode is expected to be closed 7d78a49 @bep #10675
Add some shortcode testcases 0dbeac8 @bep #10671
sass: Remove some unused leftover code b99d073 @bep
resources/sass: Remove debug statements e965cb6 @jmooring #10470
page: Move the cache double check right after the lock 586fea0 @bep
page: Add some concurrency to the building of the related page index fa2d7ad @bep #10711
related: Adjust benchmark 4346987 @bep
tocss: Simplify the hugo:vars type handling ecf3cd5 @bep #10632
Adjust tests for GO 1.20 6abd15e @bep #10691
tpl/internal: Sync Go template src to Go 1.20 094135f @bep #10691
Add page fragments support to Related 90da766 @bep #10711 #9339 #10725
related: Adjust benchmark 0afec0a @bep
related: Add benchmark 28540ed @bep
tpl/collections: Improve error message in Index 9af78d1 @bep
Make the HTML collector parsing more robust d33a7eb @bep #10698
tpl/strings: Add strings.ContainsNonSpace fce0890 @bep
publisher: Add benchmark 4f4a1c0 @bep
Update CONTRIBUTING.md e2cfc3d @bep
Only invoke a given cached partial once 4ef9baf @bep #4086 #9588

Dependency Updates

Revert "build(deps): bump gocloud.dev from 0.24.0 to 0.28.0 (#10610)" db9f74d @bep #10770
build(deps): bump github.com/tdewolff/parse/v2 from 2.6.4 to 2.6.5 4d36b99 @dependabot[bot]
build(deps): bump github.com/mattn/go-isatty from 0.0.16 to 0.0.17 807237b @dependabot[bot]
build(deps): bump golang.org/x/image 79b03b3 @dependabot[bot]
build(deps): bump golang.org/x/net from 0.4.0 to 0.7.0 4bf91b9 @dependabot[bot]
Revert "build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.114.0" 2a364cc @bep
deps: Upgrade github.com/yuin/goldmark v1.5.3 => v1.5.4 3fb2417 @jmooring #10661
build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.114.0 87c78bd @dependabot[bot]
deps: Upgrade github.com/alecthomas/chroma v2.4.0 => v2.5.0 69c369e @jmooring #9890 #10692
build(deps): bump github.com/kyokomi/emoji/v2 from 2.2.10 to 2.2.11 dd37163 @dependabot[bot]
build(deps): bump gocloud.dev from 0.24.0 to 0.28.0 (#10610) c3a59a7 @dependabot[bot] #9778

Documentation

docs: Another fix related docs example d5601e8 @bep
docs: Fix related docs example cedd04d @bep
cods: Regen docs helper a56b907 @bep
Move the Related doc counter to prevent a race 5c317c5 @bep #10768
Update README.md 93ed6e4 @bep

Build Setup

build: Update to Go 1.20 4801e2e @bep #10691
snap: Install dart-sass-embedded for 32-bit ARM (armhf) too 76c6140 @anthonyfok
snap: Add read access for ~/.gitconfig.local and ~/.config/git/* too d4482e8 @anthonyfok #10337

`v0.110.0`

Compare Source

Note

Make readFile return nil when file not found (note) 3c51625 @bep #9620
Make hugo.toml the new config.toml f38a2fb @bep #8979

Bug fixes

Fix permalinks issue with repeated sections 671f64b @bep #10377
Fix HEAD method in resources.GetRemote f13531e @bep #10604
Fix order when reading custom headers in resources.GetRemote b5d4850 @bep #10616
resource: Fix Go Doc vs .Data.Integrity fbc3e08 @bep

Improvements

related: Handly []any d595419 @bep #10624
tpl/strings: Add findRESubmatch 2fb40ec @bep #10594
config/security: Add GO\w+ (e.g. GOROOT) to the default allowed list c6b3887 @bep #10429
Preserve front matter slice value types (e.g. int) 21af5b3 @bep #10624
Make hugo.toml the new config.toml f38a2fb @bep #8979
Add fill HTTP Response info into .Data in resources.GetRemote 6a579eb @bep #10604
tpl/compare: Sort special float values as string f95fd57 @acclassic #10389
tpl/diagrams: Move Goat to its own file e754d5c @bep
Update CONTRIBUTING.md 002cd52 @bep
Update CONTRIBUTING.md a76c405 @bep

Dependency Updates

deps: Upgrade github.com/evanw/esbuild v0.15.18 => v0.17.0 6e9fa9e @bep #10536

Documentation

dos: Regen CLI docs 19e9605 @bep
docs: Regen docshelper 80e8bd3 @bep
Update README.md c4f3a46 @bep
Misc doc, code refactoring to improve documentation e402d91 @bep
Update README.md c0a03a2 @bep

Build Setup

Remove reference to Goreleaser in code comment dd6d0a6 @omarkohl

`v0.109.0`

Compare Source

Hugo v0.109.0 is the last release of 2022 – and with that we're wishing all of you a very merry Christmas and a prosperous new year[^1].

Notable new features

Pass variables to SCSS/SASS

Hugo has had great SCSS/SASS support, but passing variables (e.g. theme colours from config) down to the transpiler has been much harder than it should.

In Hugo v0.109.0 we added a new vars option and you can finally just do:

{{ $vars := dict "color1" "blue" "color2" "green" "font_size" "24px" }}
{{ $opts := (dict "transpiler" "dartsass" "outputStyle" "compressed" "vars" $vars ) }}
{{ $r := resources.Get "scss/main.scss" | toCSS $opts }}

And then in the SCSS file:

@&#8203;use "hugo:vars" as v;

p {
    color: v.$color1;
    font-size: v.$font-size;
}

More examples here.

Hugo Module Workspaces

Workspace support was added in Go 1.18, and in this release Hugo finally gets solid support for it.

A common use case for a workspace is to simplify local development of a site with its theme modules.

A workspace can be configured in a *.work file and activated with the module.workspace setting, which for this use is commonly controlled via the HUGO_MODULE_WORKSPACE OS environment variable.

See the hugo.work file in the Hugo Docs repo for an example:

go 1.19

use .
use ../gohugoioTheme

Using the use directive, list all the modules you want to work on, pointing to its relative location. As in the example above, it's recommended to always include the main project (the ".") in the list.

With that you can start the Hugo server with that workspace enabled:

HUGO_MODULE_WORKSPACE=hugo.work hugo server --ignoreVendorPaths "**"

The --ignoreVendorPaths flag is added above to ignore any of the vendored dependencies inside _vendor. If you don't use vendoring, you don't need that flag. But now the server is set up watching the files and directories in the workspace and you can see your local edits reloaded.

Breadcrumbs

We have added a new .Ancestors method on Page that walks up the tree to the home page. With this, breadcrumbs templates can be greatly simplified:

<ol>
  <ul>
    {{- range .Ancestors.Reverse }}
      <li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
    {{- end }}
    <li class="active" aria-current="page">
      <a href="{{ .Permalink }}">{{ .Title }}</a>
    </li>
  </ul>
</ol>

The path to /public now available in PostCSS

So you can do process.env.HUGO_PUBLISHDIR in your postcss.config.js to figure out where Hugo publishes
its files.

Note that the value will always be an absolute file path and will point to a directory on disk even when running hugo server in memory mode.

If you write to this folder from PostCSS when running the server, you could run the server with one of these flags:

hugo server --renderToDisk
hugo server --renderStaticToDisk

Note

modules: Make the module.workspace=off as default (note) 0d4b17d @bep #10553
release: Add a note section in release notes 3afaca7 @bep
helpers: Allow at signs in UnicodeSanitize (note) 2d217cb @jmooring #10548
Also consider wrapped errors when checking for file IsNotExist errors ad20598 @bep #10534

Bug fixes

If you use the legacy libsass transpiler in toCSS and uses the cached build to avoid having the extended version installed on the CI server, you need to rebuild those assets and commit them to source control (e.g. with hugo --gc).
tpl/resources: Fix data race in ToCSS aa2c724 @bep #10542
tocss: Fix unquote case with double quotes 5d5f0a2 @septs #10555
resources/js: Fix some import discrepancies between Hugo and ESBuild b54de1b @bep #10527
parser/metadecoders: Fix spelling e0e63f3 @lacamera

Improvements

Adjust "you need the extended version" error message 180dfeb @bep
resource/page: Slight adjustment of Page.Ancestors eb0c8f9 @bep #10567
resource/page: Add Page.Ancestors 3a21618 @septs #10567
Annotate test assertions 7183232 @jmooring
hugolib: Exclude non-linkable pages from translations map 37ab1cf @jmooring #9073
Add HUGO_PUBLISHDIR to the Node environment 59af05c @bep #10554
Revert "tpl/tplimpl: Use https in sitemap templates" 4989da6 @jmooring
tocss: Add some more test cases effa6a4 @bep #10555
Allow "fast render mode" even if --disableLiveReload is set d20d265 @bep #10561
tocss: Add vars option 41a080b @bep #10555
modules: Improve "module workspace" not found error eda1e72 @bep
modules: Adjust watch logic vs workspace use definitions 330fa89 @bep
Add any configured Go Workspace file to the config watcher 6db5274 @bep #10556
parser/metadecoders: Remove superflous cast in test 17055d1 @bep
parser/metadecoders: Simplify nil check in Unmarshal 2a81a49 @bep
parser/metadecoders: Add empty /data JSON file as empty map e30d711 @acclassic #8601
tpl/openapi3: Wrap *kopenapi3.T 87e898a @bep
github: Use ruby/setup-ruby d894269 @bep #10517
tpl/tplimpl: Use https in sitemap templates 3fd0b78 @jmooring #10515

Dependency Updates

build(deps): bump golang.org/x/tools from 0.3.0 to 0.4.0 7874b96 @dependabot[bot]

Documentation

docs: Regen docs helper JSON 10bb29d @bep
tpl: Improve template funcs GoDoc cd1ed56 @bep

Build Setup

github: Update to Dart Sass 1.56.2 c9354d5 @bep

^1]: We're working on some bigger and even more exiting Hugo features that will be ready early next year. Stay tuned!

### [`v0.108.0`](https://github.com/gohugoio/hugo/releases/tag/v0.108.0)

[Compare Source](https://github.com/gohugoio/hugo/compare/v0.107.0...v0.108.0)

With Hugo `v0.108.0` you can render standalone Markdown images without a surrounding paragraph. Both the HTML- and CommonMark-specification defines image as an inline element. For Markdown, this has meant that if you put an image on its own (not *inlined* in another paragraph), it would be wrapped in `<p></p>` tags, even if you provide your own [Render Hook Template](https://gohugo.io/templates/render-hooks/).

Now you can get by this annoyance by setting `markup.goldmark.parser.wrapStandAloneImageWithinParagraph = false`

```toml
[markup]
  [markup.goldmark]
    [markup.goldmark.parser]
      wrapStandAloneImageWithinParagraph = false
      [markup.goldmark.parser.attribute]
        block = true
```

In the above we have also enabled attribute support for Markdown blocks to illustrate another nice side effect of this; it's now possible to use Markdown attributes (e.g. CSS classes) on standalone images:

```md
This is an inline image: ![Inline Image](/inline.jpg). Some more text.

![Block Image](/block.jpg)
{.blue}
```

The images in the above Markdown example would, given the hook template below, be rendered wrapped in a `figure` element with the `blue` CSS class applied in the latter example.

```handlebars
{{ if .IsBlock }}<figure class="{{ .Attributes.class }}"><img src="{{ .Destination | safeURL }}" alt="{{ .Text }}" /></figure>
{{ else }}<img src="{{ .Destination | safeURL }}" alt="{{ .Text }}" />{{ end }}
```

Two new fields are added to the render context passed to image render hooks:

-   `IsBlock`: Returns true if this is a standalone image and the config option [markup.goldmark.parser.wrapStandAloneImageWithinParagraph](https://gohugo.io/getting-started/configuration-markup/#goldmark) is disabled.
-   `Ordinal`: Zero-based ordinal for all the images in the current document.

#### Bug fixes

-   common/hugio: Fix multiWriteCloser.Close [`5067775`](https://github.com/gohugoio/hugo/commit/5067775a) [@&#8203;bep](https://github.com/bep) [#&#8203;10505](https://github.com/gohugoio/hugo/issues/10505)
-   tpl/collections: Fix some index cases where the indices given is a slice and be more lenient with nil inputs [`d373774`](https://github.com/gohugoio/hugo/commit/d373774c) [@&#8203;bep](https://github.com/bep) [#&#8203;10489](https://github.com/gohugoio/hugo/issues/10489)

#### Improvements

-   Make the hugo env non verbose output slightly more verbose [`f97544a`](https://github.com/gohugoio/hugo/commit/f97544a8) [@&#8203;bep](https://github.com/bep)
-   Add dart-sass-embedded version info to hugo env -v [`d8efe08`](https://github.com/gohugoio/hugo/commit/d8efe085) [@&#8203;bep](https://github.com/bep)
-   tpl/embedded: Make Open Graph's series optional [`b82b547`](https://github.com/gohugoio/hugo/commit/b82b547a) [@&#8203;razonyang](https://github.com/razonyang)
-   dartsass: Add sourceMapIncludeSources option [`e93138d`](https://github.com/gohugoio/hugo/commit/e93138df) [@&#8203;bep](https://github.com/bep)
-   github: Update Dart Sass Embedded to 1.56.1 [`7d16c3c`](https://github.com/gohugoio/hugo/commit/7d16c3c0) [@&#8203;bep](https://github.com/bep)
-   markup/goldmark: Add removeSurroundingParagraph for Markdown images [`63126c6`](https://github.com/gohugoio/hugo/commit/63126c63) [@&#8203;bep](https://github.com/bep) [#&#8203;8362](https://github.com/gohugoio/hugo/issues/8362) [#&#8203;10492](https://github.com/gohugoio/hugo/issues/10492) [#&#8203;10494](https://github.com/gohugoio/hugo/issues/10494) [#&#8203;10501](https://github.com/gohugoio/hugo/issues/10501)
-   tpl/tplimpl: Allow alternate comment syntax [`0b976d2`](https://github.com/gohugoio/hugo/commit/0b976d2b) [@&#8203;jmooring](https://github.com/jmooring) [#&#8203;10495](https://github.com/gohugoio/hugo/issues/10495)
-   resources: Increase timeout for http.Client [`a49e51f`](https://github.com/gohugoio/hugo/commit/a49e51fd) [@&#8203;dirtymew](https://github.com/dirtymew) [#&#8203;10478](https://github.com/gohugoio/hugo/issues/10478)
-   config/security: Add CI env var to whitelist [`dc44bca`](https://github.com/gohugoio/hugo/commit/dc44bca9) [@&#8203;septs](https://github.com/septs)
-   tpl: Use consistent delimiter spacing in examples [`b8d5c37`](https://github.com/gohugoio/hugo/commit/b8d5c378) [@&#8203;jmooring](https://github.com/jmooring)

#### Dependency Updates

-   deps: Upgrade github.com/bep/godartsass v0.15.0 => v0.16.0 [`f5b5b71`](https://github.com/gohugoio/hugo/commit/f5b5b71c) [@&#8203;bep](https://github.com/bep)
-   build(deps): bump github.com/getkin/kin-openapi from 0.109.0 to 0.110.0 [`50549c8`](https://github.com/gohugoio/hugo/commit/50549c86) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/evanw/esbuild from 0.15.16 to 0.15.18 [`535ea8c`](https://github.com/gohugoio/hugo/commit/535ea8cc) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump golang.org/x/text from 0.4.0 to 0.5.0 [`8bbec42`](https://github.com/gohugoio/hugo/commit/8bbec426) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/evanw/esbuild from 0.15.15 to 0.15.16 [`0bfa293`](https://github.com/gohugoio/hugo/commit/0bfa293d) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   deps: Upgrade github.com/bep/godartsass v0.14.0 => v0.15.0 [`83080df`](https://github.com/gohugoio/hugo/commit/83080df6) [@&#8203;bep](https://github.com/bep)

#### Documentation

-   docs: Add basic doc for wrapStandAloneImageWithinParagraph etc. [`de9c554`](https://github.com/gohugoio/hugo/commit/de9c5542) [@&#8203;bep](https://github.com/bep) [#&#8203;10492](https://github.com/gohugoio/hugo/issues/10492)
-   tpl: Misco GoDoc improvements [`7d5e3ab`](https://github.com/gohugoio/hugo/commit/7d5e3ab8) [@&#8203;bep](https://github.com/bep)
-   docs: Regen docs helper [`75f782a`](https://github.com/gohugoio/hugo/commit/75f782a5) [@&#8203;bep](https://github.com/bep)

### [`v0.107.0`](https://github.com/gohugoio/hugo/releases/tag/v0.107.0)

[Compare Source](https://github.com/gohugoio/hugo/compare/v0.106.0...v0.107.0)

This release is mostly interesting if you do code highlighting. We fixed a bottle neck which should show a significant performance boost for sites using code highlighting. Hugo's [gohugo.io](https://gohugo.io/) docs site builds ~20% faster. Also, Chroma, the highlighting library, is upgraded to [v2.4.0](https://github.com/alecthomas/chroma/releases/tag/v2.4.0) with new lexers and lots of improvements.

#### Bug fixes

-   hugo/parser: Fix shortcode boolean param parsing [`00fe7e0`](https://github.com/gohugoio/hugo/commit/00fe7e04) [@&#8203;jmooring](https://github.com/jmooring) [#&#8203;10451](https://github.com/gohugoio/hugo/issues/10451)

#### Improvements

-   Add a cache for lexers.Get [`7855b47`](https://github.com/gohugoio/hugo/commit/7855b47f) [@&#8203;bep](https://github.com/bep)
-   markup/goldmark: Improve benchmark [`34d1150`](https://github.com/gohugoio/hugo/commit/34d1150d) [@&#8203;bep](https://github.com/bep)
-   commands: Create assets directory with new site [`85e2ac1`](https://github.com/gohugoio/hugo/commit/85e2ac1a) [@&#8203;jmooring](https://github.com/jmooring) [#&#8203;10460](https://github.com/gohugoio/hugo/issues/10460)

#### Dependency Updates

-   build(deps): bump github.com/getkin/kin-openapi from 0.108.0 to 0.109.0 [`6a004b8`](https://github.com/gohugoio/hugo/commit/6a004b8d) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/evanw/esbuild from 0.15.14 to 0.15.15 [`0923622`](https://github.com/gohugoio/hugo/commit/09236224) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/frankban/quicktest from 1.14.3 to 1.14.4 [`7477672`](https://github.com/gohugoio/hugo/commit/74776726) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump golang.org/x/tools from 0.2.0 to 0.3.0 [`63f7f0f`](https://github.com/gohugoio/hugo/commit/63f7f0ff) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   deps: Upgrade github.com/alecthomas/chroma/v2 v2.4.0 [`bcb62d8`](https://github.com/gohugoio/hugo/commit/bcb62d89) [@&#8203;bep](https://github.com/bep)

### [`v0.106.0`](https://github.com/gohugoio/hugo/releases/tag/v0.106.0)

[Compare Source](https://github.com/gohugoio/hugo/compare/v0.105.0...v0.106.0)

#### Bug fixes

-   Fix taxonomy weight sort regression [`52ea07d`](https://github.com/gohugoio/hugo/commit/52ea07d2) [@&#8203;bep](https://github.com/bep) [#&#8203;10406](https://github.com/gohugoio/hugo/issues/10406)
-   tlp/resources: resources.Get returns nil when given empty string [`db945a6`](https://github.com/gohugoio/hugo/commit/db945a6e) [@&#8203;shifterbit](https://github.com/shifterbit)
-   tpl/internal: Sync go_templates [`f6ab955`](https://github.com/gohugoio/hugo/commit/f6ab9553) [@&#8203;bep](https://github.com/bep) [#&#8203;10411](https://github.com/gohugoio/hugo/issues/10411)

#### Dependency Updates

-   build(deps): bump github.com/pelletier/go-toml/v2 from 2.0.4 to 2.0.6 [`bafb389`](https://github.com/gohugoio/hugo/commit/bafb389b) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/evanw/esbuild from 0.15.13 to 0.15.14 [`cdd83bf`](https://github.com/gohugoio/hugo/commit/cdd83bf3) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   deps: Update the libweb version string [`e00220a`](https://github.com/gohugoio/hugo/commit/e00220a0) [@&#8203;bep](https://github.com/bep)
-   deps: Upgrade github.com/bep/gowebp v0.1.0 => v0.2.0 [`a662dda`](https://github.com/gohugoio/hugo/commit/a662ddae) [@&#8203;bep](https://github.com/bep)
-   build(deps): bump github.com/yuin/goldmark from 1.5.2 to 1.5.3 [`fe08d35`](https://github.com/gohugoio/hugo/commit/fe08d35f) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/spf13/afero from 1.9.2 to 1.9.3 [`4b675dd`](https://github.com/gohugoio/hugo/commit/4b675ddd) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/getkin/kin-openapi from 0.107.0 to 0.108.0 [`24eaa29`](https://github.com/gohugoio/hugo/commit/24eaa290) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/clbanning/mxj/v2 from 2.5.6 to 2.5.7 [`58a98c7`](https://github.com/gohugoio/hugo/commit/58a98c77) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump golang.org/x/net from 0.1.0 to 0.2.0 [`900904f`](https://github.com/gohugoio/hugo/commit/900904fd) [@&#8203;dependabot](https://github.com/dependabot)\[bot]
-   build(deps): bump github.com/evanw/esbuild from 0.15.12 to 0.15.13 [`24eca0c`](https://github.com/gohugoio/hugo/commit/24eca0cb) [@&#8203;dependabot](https://github.com/dependabot)\[bot]

#### Documentation

-   docs: Regen CLI docs [`0a019a1`](https://github.com/gohugoio/hugo/commit/0a019a1a) [@&#8203;bep](https://github.com/bep)
-   docs: Regenerate docs helper [`9f7fb0a`](https://github.com/gohugoio/hugo/commit/9f7fb0a7) [@&#8203;bep](https://github.com/bep)
-   Add Go 1.16+ install method to README [`60e0e2c`](https://github.com/gohugoio/hugo/commit/60e0e2c1) [@&#8203;vgnh](https://github.com/vgnh)
-   readme: Update ToC [`13adf3e`](https://github.com/gohugoio/hugo/commit/13adf3e0) [@&#8203;vgnh](https://github.com/vgnh)

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNS4xMC4yIiwidXBkYXRlZEluVmVyIjoiMzUuMTAyLjciLCJ0YXJnZXRCcmFuY2giOiJtYWluIn0=-->

This PR contains the following updates: | Package | Update | Change | |---|---|---| | [gohugoio/hugo](https://github.com/gohugoio/hugo) | minor | `v0.105.0` -> `v0.112.5` | --- ### Release Notes <details> <summary>gohugoio/hugo</summary> ### [`v0.112.5`](https://github.com/gohugoio/hugo/releases/tag/v0.112.5) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.112.4...v0.112.5) #### What's Changed - Fix it so languageCode on top level config still works [`e3dfc76`](https://github.com/gohugoio/hugo/commit/e3dfc76f) [@bep](https://github.com/bep) [#11037](https://github.com/gohugoio/hugo/issues/11037) ### [`v0.112.4`](https://github.com/gohugoio/hugo/releases/tag/v0.112.4) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.112.3...v0.112.4) - Fix Processed images count regression for multiple languages [`fd09933`](https://github.com/gohugoio/hugo/commit/fd099331) [@bep](https://github.com/bep) [#11002](https://github.com/gohugoio/hugo/issues/11002) - Fix --renderStaticToDisk regression [`8f293a1`](https://github.com/gohugoio/hugo/commit/8f293a18) [@bep](https://github.com/bep) [#11026](https://github.com/gohugoio/hugo/issues/11026) - commands: Add the common build flags to the config commands [`51d0a0a`](https://github.com/gohugoio/hugo/commit/51d0a0ab) [@bep](https://github.com/bep) [#11018](https://github.com/gohugoio/hugo/issues/11018) - commands: Reinstate some of the removed build flags (e.g. --theme) to new and mod [`43f1282`](https://github.com/gohugoio/hugo/commit/43f1282e) [@bep](https://github.com/bep) [#11018](https://github.com/gohugoio/hugo/issues/11018) - Don't create the public folder unless needed [`e96cdfe`](https://github.com/gohugoio/hugo/commit/e96cdfe9) [@bep](https://github.com/bep) [#11031](https://github.com/gohugoio/hugo/issues/11031) - commands: Fail the build when no config file or config dir [`273d9f6`](https://github.com/gohugoio/hugo/commit/273d9f69) [@bep](https://github.com/bep) [#11019](https://github.com/gohugoio/hugo/issues/11019) - langs: Remove the Language.Params deprecation message for now [`a6257d8`](https://github.com/gohugoio/hugo/commit/a6257d8a) [@bep](https://github.com/bep) [#11025](https://github.com/gohugoio/hugo/issues/11025) - Add language.LanguageCode [`6c2db0d`](https://github.com/gohugoio/hugo/commit/6c2db0df) [@bep](https://github.com/bep) [#11027](https://github.com/gohugoio/hugo/issues/11027) - commands: Re-introduce the -f shorthand for hugo new site [`901cd97`](https://github.com/gohugoio/hugo/commit/901cd970) [@bep](https://github.com/bep) [#11015](https://github.com/gohugoio/hugo/issues/11015) - commands: Move the --format flag to only the commands that support it [`f86b5f7`](https://github.com/gohugoio/hugo/commit/f86b5f70) [@bep](https://github.com/bep) [#11022](https://github.com/gohugoio/hugo/issues/11022) #### Documentation - docs: Regenerate CLI docs [`20ea2e0`](https://github.com/gohugoio/hugo/commit/20ea2e0c) [@bep](https://github.com/bep) - docs: Regen CLI docs [`ffdbce5`](https://github.com/gohugoio/hugo/commit/ffdbce57) [@bep](https://github.com/bep) ### [`v0.112.3`](https://github.com/gohugoio/hugo/releases/tag/v0.112.3) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.112.2...v0.112.3) #### What's Changed - Fix regression when loading config -e is empty or HUGO_ENV or HUGO_ENVIRONMENT is set [`231374a`](https://github.com/gohugoio/hugo/commit/231374a1) [@bep](https://github.com/bep) [#11013](https://github.com/gohugoio/hugo/issues/11013) ### [`v0.112.2`](https://github.com/gohugoio/hugo/releases/tag/v0.112.2) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.112.1...v0.112.2) #### What's Changed - minifiers: Make sure JS.Version always has a value [`dd67922`](https://github.com/gohugoio/hugo/commit/dd679220) [@bep](https://github.com/bep) [#11012](https://github.com/gohugoio/hugo/issues/11012) - Fix regression with site.IsServer when not running a server [`9a235d0`](https://github.com/gohugoio/hugo/commit/9a235d0a) [@bep](https://github.com/bep) [#11006](https://github.com/gohugoio/hugo/issues/11006) ### [`v0.112.1`](https://github.com/gohugoio/hugo/releases/tag/v0.112.1) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.112.0...v0.112.1) #### What's Changed - Fix regression when config for OutputFormat.BaseName is an empty string [`ed906a8`](https://github.com/gohugoio/hugo/commit/ed906a86) [@bep](https://github.com/bep) [#11000](https://github.com/gohugoio/hugo/issues/11000) Also see the main release: https://github.com/gohugoio/hugo/releases/tag/v0.112.0 ### [`v0.112.0`](https://github.com/gohugoio/hugo/releases/tag/v0.112.0) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.111.3...v0.112.0) > **Note:** There's a patch release out already, see https://github.com/gohugoio/hugo/releases/tag/v0.112.1 Proper **TailwindCSS v3.x support**, much improved **language config merge**, consolidation of all Hugo config (check out `hugo config`), rewritten `commands` package (CLI) using [SimpleCobra](https://github.com/bep/simplecobra), Goldmark's typographer extension (quotation marks per language), and more. #### Headlines ##### TailwindCSS v3.x Support, new cache buster configuration > See https://github.com/bep/hugo-starter-tailwind-basic for a running example. TailwindCSS 3 has been out for a while now, and unfortunately their new build strategy didn't work very well with Hugo. But this release adds a new `build.cachebusters` config option for the resource cache that allows more fine grained control over when to trigger a new Tailwind build. This is a generally useful feature, so if you're having issues not seeing your resource changes (e.g. change to a JS file) on change, you could try to tweak the defaults. A tip is to run the server with `hugo server --debug` and watch out for log messages prefixed with `cachebuster:` on file changes. There are several possible setups here, but one that we have tested and that works well is outlined in the config below. The basic concept is to add `hugo_stats.json` to the server watcher list in Hugo and trigger a new TailwindCSS build only whenever either this file or the main CSS file changes. ```toml [module] [[module.mounts]] source = "assets" target = "assets" [[module.mounts]] source = "hugo_stats.json" target = "assets/watching/hugo_stats.json" [build] writeStats = true [[build.cachebusters]] source = "assets/watching/hugo_stats\\.json" target = "styles\\.css" [[build.cachebusters]] source = "(postcss|tailwind)\\.config\\.js" target = "css" [[build.cachebusters]] source = "assets/.*\\.(js|ts|jsx|tsx)" target = "js" [[build.cachebusters]] source = "assets/.*\\.(.*)$" target = "$1" ``` And then in `tailwind.config.js`: ```js module.exports = { content: ['./hugo_stats.json'], }; ``` ##### Reconsolidated all configuration handling For this release we have collected all configuration into one big Go struct and rewritten the command line API using [SimpleCobra](https://github.com/bep/simplecobra). All of this makes the source code easier to maintain and understand, but the original motivation for this was to get a complete and autogenerated API reference for Hugo (we're working on getting that done), but this also have some less technical upsides: ##### 'hugo config' is now complete What you get when running `hugo config` is a complete TOML representation (add `--format json` or `--format yaml` for alternative formats) of *the effective* configuration. As this will include default values and configuration merged in from themes, we don't recommend to copy and paste this into `hugo.toml`, as that would make your configuration very verbose. ##### Improved language config handling See issue [#10620](https://github.com/gohugoio/hugo/issues/10620) for some details, but in general, the merge behaviour of sections from `languages` is much improved. In the example below for language `en` you will now get: ```json "comments": { "color": "blue", "title": "English Comments Title", } ``` In earlier versions of Hugo you would get: ```json "comments": { "title": "English Comments Title", } ``` ```toml title = "Base Title" staticDir = "mystatic" [params] [params.comments] color = "blue" title = "Default Comments Title" [languages] [languages.en] title = "English Title" [languages.en.params.comments] title = "English Comments Title" ``` Note that values in a given language will always have precedence over same keys in root (the section inside the language is the receiving side of any merge operation), so, if you want the old (and buggy) behaviour, you can add a merge strategy to one of the `params` sections, e.g: ```toml [languages.en.params.comments] _merge = "none" title = "English Comments Title" ``` You can now also configure just about *everything* per language. One useful example would be the Goldmark `typographer` extension: ```toml [languages.de] languageCode = 'de-DE' languageName = 'Deutsch' weight = 2 [languages.de.markup.goldmark.extensions.typographer] leftDoubleQuote = '«' # default “ rightDoubleQuote = '»' # default ” ``` ##### More info in verbose build output If you build flag with the `-v`, you will now get timing info for the core building steps in Hugo: INFO 2023/05/16 09:53:55 process in 17 ms INFO 2023/05/16 09:53:55 assemble in 345 ms INFO 2023/05/16 09:53:55 render in 341 ms INFO 2023/05/16 09:53:55 postProcess in 0 ms #### Notes - openapi2: .ExtensionProps is now .Extensions and just a map. - We have deprecated `site.Language.Params` and configuration of custom params outside of the language `[params]`, see https://gohugo.io/content-management/multilingual/#changes-in-hugo-01120 for more information. #### Bug fixes - Fix "unknown command" message when no suggestion [`288be19`](https://github.com/gohugoio/hugo/commit/288be197) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - commands: Fix build logic when listing expired/future draft content [`e6dc805`](https://github.com/gohugoio/hugo/commit/e6dc8053) [@bep](https://github.com/bep) [#10972](https://github.com/gohugoio/hugo/issues/10972) - commands: Fix data race [`0a51dfa`](https://github.com/gohugoio/hugo/commit/0a51dfac) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - tpl/urls: Fix build broken by a merge [`e4e0313`](https://github.com/gohugoio/hugo/commit/e4e0313c) [@bep](https://github.com/bep) - Fix warn message about custom params on the language top level [`ad4bc96`](https://github.com/gohugoio/hugo/commit/ad4bc969) [@deining](https://github.com/deining) - Fix some spelling mistakes [`4003c79`](https://github.com/gohugoio/hugo/commit/4003c790) [@cuishuang](https://github.com/cuishuang) - all: Fix comments for exported functions and packages [`610ceda`](https://github.com/gohugoio/hugo/commit/610cedaa) [@alexandear](https://github.com/alexandear) - modules: Fix format flag in error [`95818e2`](https://github.com/gohugoio/hugo/commit/95818e27) [@alexandear](https://github.com/alexandear) - Fix some recently introduced error handling issues [`834b3d7`](https://github.com/gohugoio/hugo/commit/834b3d7e) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - Re-add site.LanguagePrefix [`86b2a27`](https://github.com/gohugoio/hugo/commit/86b2a274) [@bep](https://github.com/bep) [#10947](https://github.com/gohugoio/hugo/issues/10947) - Deprecate site.Language.Params and some other fixes [`5d85716`](https://github.com/gohugoio/hugo/commit/5d857165) [@bep](https://github.com/bep) [#10947](https://github.com/gohugoio/hugo/issues/10947) - readme: Fix build command [`d01731d`](https://github.com/gohugoio/hugo/commit/d01731d5) [@kirisakow](https://github.com/kirisakow) - resources: Fix typos in error message and variables [`891b291`](https://github.com/gohugoio/hugo/commit/891b2918) [@alexandear](https://github.com/alexandear) - commands: Fix data race in test [`0fbab7c`](https://github.com/gohugoio/hugo/commit/0fbab7cb) [@bep](https://github.com/bep) #### Improvements - circleci: Add github.com to known hosts [`70b2aaf`](https://github.com/gohugoio/hugo/commit/70b2aaf8) [@bep](https://github.com/bep) - Add --format to hugo config [`85b13c1`](https://github.com/gohugoio/hugo/commit/85b13c10) [@bep](https://github.com/bep) - postcss: Improve validation of option 'config' [`9a0370e`](https://github.com/gohugoio/hugo/commit/9a0370e8) [@deining](https://github.com/deining) - Avoid writing to hugo_stats.json when there are no changes [`4cac5f5`](https://github.com/gohugoio/hugo/commit/4cac5f5e) [@bep](https://github.com/bep) [#10985](https://github.com/gohugoio/hugo/issues/10985) - Add cache busting config to support Tailwind 3 [`2c3d4df`](https://github.com/gohugoio/hugo/commit/2c3d4dfb) [@bep](https://github.com/bep) [#10974](https://github.com/gohugoio/hugo/issues/10974) - commands: Make all list commands list what 'all' did before [`6ca8a40`](https://github.com/gohugoio/hugo/commit/6ca8a40f) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - tpl/tplimpl: Add img loading attribute to figure shortcode ([#10927](https://github.com/gohugoio/hugo/issues/10927)) [`2db7ec6`](https://github.com/gohugoio/hugo/commit/2db7ec62) [@InLaw](https://github.com/InLaw) - Allow whitelisting mediaTypes used in resources.GetRemote [`2637b4e`](https://github.com/gohugoio/hugo/commit/2637b4ef) [@bep](https://github.com/bep) [#10286](https://github.com/gohugoio/hugo/issues/10286) - Add hugo.WorkingDir [`7c7baa6`](https://github.com/gohugoio/hugo/commit/7c7baa61) [@bep](https://github.com/bep) [#10969](https://github.com/gohugoio/hugo/issues/10969) - Make language merging of markup etc. config without values in the root [`4f085e8`](https://github.com/gohugoio/hugo/commit/4f085e80) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - tpl/urls: Return empty string when JoinPath has zero args [`150d190`](https://github.com/gohugoio/hugo/commit/150d190f) [@jmooring](https://github.com/jmooring) - Re-add --printUnusedTemplates and --printPathWarnings [`d6197a4`](https://github.com/gohugoio/hugo/commit/d6197a41) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - tpl/urls: Add JoinPath template function [`5b3e165`](https://github.com/gohugoio/hugo/commit/5b3e165b) [@jmooring](https://github.com/jmooring) [#9694](https://github.com/gohugoio/hugo/issues/9694) - Allow legacy taxonomyTerm in disableKinds [`03cb38e`](https://github.com/gohugoio/hugo/commit/03cb38e6) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - Make GOMAXPROCS to be CPU limit aware [`008170c`](https://github.com/gohugoio/hugo/commit/008170c8) [@BenTheElder](https://github.com/BenTheElder) [#10950](https://github.com/gohugoio/hugo/issues/10950) - Allow empty params.mainSections [`7c647bc`](https://github.com/gohugoio/hugo/commit/7c647bca) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - commands: Load config before creating the filesystem [`3f00f47`](https://github.com/gohugoio/hugo/commit/3f00f475) [@bep](https://github.com/bep) - github: Trim the test flow a little [`35955f5`](https://github.com/gohugoio/hugo/commit/35955f50) [@bep](https://github.com/bep) - commands: Improve the common build flag handling [`8a69ccb`](https://github.com/gohugoio/hugo/commit/8a69ccbb) [@bep](https://github.com/bep) [#10947](https://github.com/gohugoio/hugo/issues/10947) - Support, but warn, about top level language custom params [`7ce033a`](https://github.com/gohugoio/hugo/commit/7ce033a8) [@bep](https://github.com/bep) [#10947](https://github.com/gohugoio/hugo/issues/10947) - Handle transient errors in config loading etc. [`0554213`](https://github.com/gohugoio/hugo/commit/05542130) [@bep](https://github.com/bep) [#10947](https://github.com/gohugoio/hugo/issues/10947) - Re-establish all the server flags [`5251f01`](https://github.com/gohugoio/hugo/commit/5251f015) [@bep](https://github.com/bep) [#10947](https://github.com/gohugoio/hugo/issues/10947) - Revert "Make GOMAXPROCS CPU limit aware" [`0106cf1`](https://github.com/gohugoio/hugo/commit/0106cf1a) [@bep](https://github.com/bep) - Make GOMAXPROCS CPU limit aware [`59050f9`](https://github.com/gohugoio/hugo/commit/59050f97) [@BenTheElder](https://github.com/BenTheElder) [#10950](https://github.com/gohugoio/hugo/issues/10950) - Add Sections to Site interface [`faa6998`](https://github.com/gohugoio/hugo/commit/faa6998f) [@bep](https://github.com/bep) [#10947](https://github.com/gohugoio/hugo/issues/10947) - helpers: simplify path tests with T.TempDir [`3d90871`](https://github.com/gohugoio/hugo/commit/3d90871e) [@alexandear](https://github.com/alexandear) - tpl: Add math.Abs [`bda082c`](https://github.com/gohugoio/hugo/commit/bda082c9) [@alexandear](https://github.com/alexandear) [#10941](https://github.com/gohugoio/hugo/issues/10941) - Create a struct with all of Hugo's config options [`241b21b`](https://github.com/gohugoio/hugo/commit/241b21b0) [@bep](https://github.com/bep) [#10896](https://github.com/gohugoio/hugo/issues/10896) [#10620](https://github.com/gohugoio/hugo/issues/10620) - Improve date parsing performance for the common case [`6aededf`](https://github.com/gohugoio/hugo/commit/6aededf6) [@bep](https://github.com/bep) [#10942](https://github.com/gohugoio/hugo/issues/10942) - Add a counter helper [`0988b76`](https://github.com/gohugoio/hugo/commit/0988b76a) [@bep](https://github.com/bep) - Expand the baseline benchmark a little [`e0e19a9`](https://github.com/gohugoio/hugo/commit/e0e19a93) [@bep](https://github.com/bep) - Revert "Update syntax-highlighting.md ([#10929](https://github.com/gohugoio/hugo/issues/10929))" ([#10930](https://github.com/gohugoio/hugo/issues/10930)) [`bcd7ac7`](https://github.com/gohugoio/hugo/commit/bcd7ac77) [@jmooring](https://github.com/jmooring) - Update syntax-highlighting.md ([#10929](https://github.com/gohugoio/hugo/issues/10929)) [`a4fb8dc`](https://github.com/gohugoio/hugo/commit/a4fb8dc6) [@kirillbobyrev](https://github.com/kirillbobyrev) - tpl/strings: Clarify findRESubmatch description [`5c7b79c`](https://github.com/gohugoio/hugo/commit/5c7b79cf) [@jmooring](https://github.com/jmooring) - langs/i18n: Fallback to defaultContentLanguage instead of English [`0cb6ca5`](https://github.com/gohugoio/hugo/commit/0cb6ca59) [@jmooring](https://github.com/jmooring) [#9216](https://github.com/gohugoio/hugo/issues/9216) - tpl/debug: Add VisualizeSpaces [`f106251`](https://github.com/gohugoio/hugo/commit/f1062519) [@bep](https://github.com/bep) - Prevent the global error collector to panic when sending on closed channel [`9906c1a`](https://github.com/gohugoio/hugo/commit/9906c1ae) [@bep](https://github.com/bep) - markup/goldmark: Add config options for the typographer extension [`5596dc2`](https://github.com/gohugoio/hugo/commit/5596dc24) [@bep](https://github.com/bep) [#9772](https://github.com/gohugoio/hugo/issues/9772) - Add test for ToC vs include [`5748133`](https://github.com/gohugoio/hugo/commit/5748133d) [@bep](https://github.com/bep) [#10866](https://github.com/gohugoio/hugo/issues/10866) - resources.functions: improve validation [`05c095a`](https://github.com/gohugoio/hugo/commit/05c095a0) [@deining](https://github.com/deining) - markup/goldmark: Fail on invalid Markdown attributes [`b0b1b76`](https://github.com/gohugoio/hugo/commit/b0b1b76d) [@bep](https://github.com/bep) - tpl/math: Return error if less than 2 input numbers [`f5eddf8`](https://github.com/gohugoio/hugo/commit/f5eddf89) [@septs](https://github.com/septs) [#10827](https://github.com/gohugoio/hugo/issues/10827) #### Dependency Updates - Revert "build(deps): bump gocloud.dev from 0.24.0 to 0.29.0" [`f014921`](https://github.com/gohugoio/hugo/commit/f0149211) [@bep](https://github.com/bep) [#10993](https://github.com/gohugoio/hugo/issues/10993) - build(deps): bump github.com/tdewolff/parse/v2 from 2.6.5 to 2.6.6 [`1292d5a`](https://github.com/gohugoio/hugo/commit/1292d5a2) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump gocloud.dev from 0.24.0 to 0.29.0 [`baa5569`](https://github.com/gohugoio/hugo/commit/baa55690) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/gobuffalo/flect from 0.3.0 to 1.0.2 [`a5413c1`](https://github.com/gohugoio/hugo/commit/a5413c1f) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump golang.org/x/image from 0.5.0 to 0.7.0 [`9cea58a`](https://github.com/gohugoio/hugo/commit/9cea58a8) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/tdewolff/minify/v2 from 2.12.4 to 2.12.5 [`1a5dce4`](https://github.com/gohugoio/hugo/commit/1a5dce4c) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/dustin/go-humanize from 1.0.0 to 1.0.1 [`065ae00`](https://github.com/gohugoio/hugo/commit/065ae003) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump google.golang.org/api from 0.76.0 to 0.123.0 [`1a7d57c`](https://github.com/gohugoio/hugo/commit/1a7d57c0) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump golang.org/x/tools from 0.4.0 to 0.9.1 [`bba54e6`](https://github.com/gohugoio/hugo/commit/bba54e69) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/cli/safeexec from 1.0.0 to 1.0.1 [`7370543`](https://github.com/gohugoio/hugo/commit/73705431) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.117.0 [`f6269ee`](https://github.com/gohugoio/hugo/commit/f6269ee9) [@dependabot](https://github.com/dependabot)\[bot] - deps: Update github.com/evanw/esbuild v0.17.0 => v0.17.19 [`715d484`](https://github.com/gohugoio/hugo/commit/715d4840) [@bep](https://github.com/bep) - deps: Update github.com/alecthomas/chroma/v2 v2.7.0 [`c371171`](https://github.com/gohugoio/hugo/commit/c371171a) [@bep](https://github.com/bep) - deps: Update github.com/bep/golibsass v1.1.0 => v1.1.1 [`24e7d0c`](https://github.com/gohugoio/hugo/commit/24e7d0c1) [@bep](https://github.com/bep) [#10629](https://github.com/gohugoio/hugo/issues/10629) [#10491](https://github.com/gohugoio/hugo/issues/10491) #### Documentation - docs: Regen docshelper [`b6e6438`](https://github.com/gohugoio/hugo/commit/b6e6438f) [@bep](https://github.com/bep) - commands: Add missing gen docshelper command [`943ff7f`](https://github.com/gohugoio/hugo/commit/943ff7f7) [@bep](https://github.com/bep) [#10953](https://github.com/gohugoio/hugo/issues/10953) - docs: Regen CLI docs [`10d0fcc`](https://github.com/gohugoio/hugo/commit/10d0fcc0) [@bep](https://github.com/bep) - tpl/lang: document delimiter option for FormatNumberCustom [`1155bbc`](https://github.com/gohugoio/hugo/commit/1155bbca) [@jmooring](https://github.com/jmooring) - Update README.md [`4f341fa`](https://github.com/gohugoio/hugo/commit/4f341fa1) [@bep](https://github.com/bep) - Update README.md [`46a3cf6`](https://github.com/gohugoio/hugo/commit/46a3cf61) [@bep](https://github.com/bep) - Update README.md [`f1e8f01`](https://github.com/gohugoio/hugo/commit/f1e8f010) [@bep](https://github.com/bep) ### [`v0.111.3`](https://github.com/gohugoio/hugo/releases/tag/v0.111.3) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.111.2...v0.111.3) #### Bug fixes - Fix "unknown shortcode token" when calling shortcode within fenced code block [`e7148f3`](https://github.com/gohugoio/hugo/commit/e7148f33) [@bep](https://github.com/bep) [#10819](https://github.com/gohugoio/hugo/issues/10819) - Don't fail when calling Paginate with an empty pages.PagesGroup [`34a86e1`](https://github.com/gohugoio/hugo/commit/34a86e13) [@bep](https://github.com/bep) [#10802](https://github.com/gohugoio/hugo/issues/10802) - Improve error message for unclosed shortcode with inner content [`9818724`](https://github.com/gohugoio/hugo/commit/9818724b) [@deining](https://github.com/deining) #### Improvements - tpl: Add hasSuffix alias [`d171d15`](https://github.com/gohugoio/hugo/commit/d171d154) [@jfish2](https://github.com/jfish2) - Run gofmt -s on source files [`d55af2a`](https://github.com/gohugoio/hugo/commit/d55af2ab) [@deining](https://github.com/deining) - tpl/math: Allow multi numbers in add, sub, mul, div, min and max [`84201e8`](https://github.com/gohugoio/hugo/commit/84201e8d) [@septs](https://github.com/septs) - server: Replace golang.org/x/net/context with context [`0f01bd4`](https://github.com/gohugoio/hugo/commit/0f01bd46) [@alexandear](https://github.com/alexandear) - watcher: use time.NewTicker to prevent leaks [`02ab77d`](https://github.com/gohugoio/hugo/commit/02ab77da) [@alexandear](https://github.com/alexandear) - ensure we default to 10 correctly [`873be9f`](https://github.com/gohugoio/hugo/commit/873be9f9) [@davidejones](https://github.com/davidejones) - switch transfers to workers [`bebb2b8`](https://github.com/gohugoio/hugo/commit/bebb2b8d) [@davidejones](https://github.com/davidejones) - customize parallel transfer count [`e6f029b`](https://github.com/gohugoio/hugo/commit/e6f029bd) [@davidejones](https://github.com/davidejones) - metadecoders: Add support for native org dates in frontmatter PR [#7433](https://github.com/gohugoio/hugo/issues/7433) added support for Org timestamps for the DATE header. This PR widens the support with additional front matter headers LASTMOD, PUBLISHDATE and EXPIRYDATE. [`bdbfacb`](https://github.com/gohugoio/hugo/commit/bdbfacb8) [@johannesengl](https://github.com/johannesengl) [#8536](https://github.com/gohugoio/hugo/issues/8536) #### Dependency Updates - deps: Update go-org to v1.6.6 [`1c841ec`](https://github.com/gohugoio/hugo/commit/1c841ec9) [@niklasfasching](https://github.com/niklasfasching) #### Documentation - docs: Improve examples of variadic math functions [`b6f44aa`](https://github.com/gohugoio/hugo/commit/b6f44aaf) [@jmooring](https://github.com/jmooring) - readme: Update dependency list [`04b9811`](https://github.com/gohugoio/hugo/commit/04b98116) [@deining](https://github.com/deining) ### [`v0.111.2`](https://github.com/gohugoio/hugo/releases/tag/v0.111.2) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.111.1...v0.111.2) #### Bug fixes - Fix .Fragments when called cross sites on uninitialized output format [`b83050c`](https://github.com/gohugoio/hugo/commit/b83050cb) [@bep](https://github.com/bep) [#10794](https://github.com/gohugoio/hugo/issues/10794) - Fix "context canceled" with partial [`3bbeb56`](https://github.com/gohugoio/hugo/commit/3bbeb568) [@bep](https://github.com/bep) [#10789](https://github.com/gohugoio/hugo/issues/10789) - cache: Fix --gc failure on Windows [`184a67a`](https://github.com/gohugoio/hugo/commit/184a67ac) [@alexandear](https://github.com/alexandear) - snap: Fix dart-sass-embedded installation [`a950950`](https://github.com/gohugoio/hugo/commit/a950950f) [@jmooring](https://github.com/jmooring) [#10783](https://github.com/gohugoio/hugo/issues/10783) - Allow page.TableOfContents on self in shortcode [`df5608f`](https://github.com/gohugoio/hugo/commit/df5608f8) [@bep](https://github.com/bep) [#10791](https://github.com/gohugoio/hugo/issues/10791) - Page context handling in i18n [`6c798eb`](https://github.com/gohugoio/hugo/commit/6c798eba) [@bep](https://github.com/bep) [#10782](https://github.com/gohugoio/hugo/issues/10782) - Work around --gc failure on Windows <= 10 [`ec1c97e`](https://github.com/gohugoio/hugo/commit/ec1c97e7) [@bep](https://github.com/bep) [#10781](https://github.com/gohugoio/hugo/issues/10781) - Correct typos in Go comments [`36ce3a4`](https://github.com/gohugoio/hugo/commit/36ce3a4a) [@alexandear](https://github.com/alexandear) #### Documentation - tpl/partial: Consolidate GoDoc [`f56ce01`](https://github.com/gohugoio/hugo/commit/f56ce01a) [@bep](https://github.com/bep) #### Build Setup - Update to Go 1.20.1 [`f10009e`](https://github.com/gohugoio/hugo/commit/f10009e7) [@bep](https://github.com/bep) [#10785](https://github.com/gohugoio/hugo/issues/10785) ### [`v0.111.1`](https://github.com/gohugoio/hugo/releases/tag/v0.111.1) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.111.0...v0.111.1) This fixes the "page" not defined issue in Hugo `0.111.0`. [`eef23a7`](https://github.com/gohugoio/hugo/commit/eef23a7f) [@bep](https://github.com/bep) [#10774](https://github.com/gohugoio/hugo/issues/10774) ### [`v0.111.0`](https://github.com/gohugoio/hugo/releases/tag/v0.111.0) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.110.0...v0.111.0) Hugo `0.111.0` is the second Hugo release of the year. **Note:** There's already a [patch release](https://github.com/gohugoio/hugo/releases/tag/v0.111.1). #### Notable news ##### Page Fragments We added the new `.Fragments` method on `Page` as part of the Related Content feature refresh (below), but it's plenty useful on its own, and has been long sought after by Hugo users. It has many uses: Build table of contents, check if a page fragment (heading identifier) exists on a page, check for duplicate heading identifiers, start table of contents from a specific heading identifier. See the [Hugo Documentation](https://gohugo.io/variables/page/#page-fragments) for more information ##### Indexing of Page Fragments in Related Content We have reworked the Related Content API so it's now one method `.Related` that takes either a `Page` or an options map. We have also introduced a new `type` attribute on the index configuration with the new type `fragments`. See [this](https://gohugo.io/content-management/related/#index-content-headings-in-related-content) for details, but to add some weight to the *page titles* in the Related Content configuration you can do this: ```toml [related] threshold = 20 includeNewer = true toLower = false [[related.indices]] name = "fragmentrefs" type = "fragments" applyFilter = false weight = 50 ``` See the [Hugo Documentation](https://gohugo.io/content-management/related/) for more. ##### Global page func **Note:** There was a bug in this release that made this new feature not working, so you need to upgrade to [Hugo 0.111.1](https://github.com/gohugoio/hugo/releases/tag/v0.111.0). We blame it on [Go](https://github.com/golang/go/issues/58823). Hugo almost always passes a `Page` as the data context into the top level template (e.g. `single.html`) (the one exception is the multihost sitemap template). This means that you can access the current page with the `.` variable in the template. But when you're deeply nested inside `.Render`, partial etc., accessing that `Page` object isn't always practical or possible. For this reason, Hugo now provides a global `page` function that you can use to access the current page from anywhere in any template. ```go-html-template {{ page.Title }} ``` #### Notes - For the Goldmark markdown hander, we now split parse and render for Goldmark. This was motivated by the new fragments support in Related Content, but it has some other side effects: If you only need a page's table of contents, we now skip the rendering step, which makes it faster, but it also means that you can access the page `.Fragments` structure from everywhere, even in render hooks ([`271318a`](https://github.com/gohugoio/hugo/commit/271318ad) [@bep](https://github.com/bep) [#10750](https://github.com/gohugoio/hugo/issues/10750)) - tpl/tplimpl: Remove the Google News internal template [`66f94b4`](https://github.com/gohugoio/hugo/commit/66f94b49) [@jmooring](https://github.com/jmooring) - Only invoke a given cached partial once [`4ef9baf`](https://github.com/gohugoio/hugo/commit/4ef9baf5) [@bep](https://github.com/bep) [#4086](https://github.com/gohugoio/hugo/issues/4086) [#9588](https://github.com/gohugoio/hugo/issues/9588) #### Bug fixes - strings: fix Truncate behavior for formatted html [`c0d15a2`](https://github.com/gohugoio/hugo/commit/c0d15a28) [@khayyamsaleem](https://github.com/khayyamsaleem) [#10399](https://github.com/gohugoio/hugo/issues/10399) - Fix shortcode error when closing without .Inner [`ae48507`](https://github.com/gohugoio/hugo/commit/ae48507d) [@bep](https://github.com/bep) [#10672](https://github.com/gohugoio/hugo/issues/10672) - create: Fix typo in error message [`2dad13c`](https://github.com/gohugoio/hugo/commit/2dad13c0) [@aaronhooper](https://github.com/aaronhooper) - resource_transformers/tocss: Fixed hugo:vars casting [`a1a9c08`](https://github.com/gohugoio/hugo/commit/a1a9c08b) [@acclassic](https://github.com/acclassic) [#10632](https://github.com/gohugoio/hugo/issues/10632) - markup: Fix linenos codeblock hl option case regression [`73ece30`](https://github.com/gohugoio/hugo/commit/73ece30d) [@khayyamsaleem](https://github.com/khayyamsaleem) [#10682](https://github.com/gohugoio/hugo/issues/10682) - Fix slow HTML elements collector for the pre case [`f9fc0e0`](https://github.com/gohugoio/hugo/commit/f9fc0e04) [@bep](https://github.com/bep) [#10698](https://github.com/gohugoio/hugo/issues/10698) - commands: Fix server url rewrites (http status 200) [`1477d0b`](https://github.com/gohugoio/hugo/commit/1477d0ba) [@bep](https://github.com/bep) [#10668](https://github.com/gohugoio/hugo/issues/10668) - Fix description of collections.Uniq [`4ccc8cf`](https://github.com/gohugoio/hugo/commit/4ccc8cfb) [@jmooring](https://github.com/jmooring) - Fix shortcode detection in RenderString [`1688583`](https://github.com/gohugoio/hugo/commit/16885833) [@bep](https://github.com/bep) [#10654](https://github.com/gohugoio/hugo/issues/10654) #### Improvements - Replace deprecated ioutil with io and os [`d453c12`](https://github.com/gohugoio/hugo/commit/d453c127) [@alexandear](https://github.com/alexandear) - build: Bump build images [`60e6fa7`](https://github.com/gohugoio/hugo/commit/60e6fa79) [@bep](https://github.com/bep) - build: Update Linux ARM build image [`7e51ba0`](https://github.com/gohugoio/hugo/commit/7e51ba03) [@bep](https://github.com/bep) - tpl/tplimpl: Remove the Google News internal template [`66f94b4`](https://github.com/gohugoio/hugo/commit/66f94b49) [@jmooring](https://github.com/jmooring) - tpl/strings: Adjust benchmark [`2a61910`](https://github.com/gohugoio/hugo/commit/2a61910e) [@bep](https://github.com/bep) - tpl/strings: Add BenchmarkTruncate [`079d1b6`](https://github.com/gohugoio/hugo/commit/079d1b65) [@bep](https://github.com/bep) - Misc ioutil deprecation adjustments [`a669467`](https://github.com/gohugoio/hugo/commit/a669467d) [@bep](https://github.com/bep) [#10732](https://github.com/gohugoio/hugo/issues/10732) - Remove unused temp directory [`e314410`](https://github.com/gohugoio/hugo/commit/e3144103) [@alexandear](https://github.com/alexandear) - exif: Return the proper exposure time value in some special cases [`39cc3a2`](https://github.com/gohugoio/hugo/commit/39cc3a2a) [@WaltCuller](https://github.com/WaltCuller) [#10738](https://github.com/gohugoio/hugo/issues/10738) - Add a page template func [`ce524d0`](https://github.com/gohugoio/hugo/commit/ce524d0b) [@bep](https://github.com/bep) [#9339](https://github.com/gohugoio/hugo/issues/9339) - dartsass: Import CSS without extension at compile time [`2662faf`](https://github.com/gohugoio/hugo/commit/2662faf6) [@jmooring](https://github.com/jmooring) [#10592](https://github.com/gohugoio/hugo/issues/10592) - Split parse and render for Goldmark [`271318a`](https://github.com/gohugoio/hugo/commit/271318ad) [@bep](https://github.com/bep) [#10750](https://github.com/gohugoio/hugo/issues/10750) - related: Add config option cardinalityThreshold [`e442a63`](https://github.com/gohugoio/hugo/commit/e442a63b) [@bep](https://github.com/bep) [#10744](https://github.com/gohugoio/hugo/issues/10744) - Throw an error when shortcode is expected to be closed [`7d78a49`](https://github.com/gohugoio/hugo/commit/7d78a498) [@bep](https://github.com/bep) [#10675](https://github.com/gohugoio/hugo/issues/10675) - Add some shortcode testcases [`0dbeac8`](https://github.com/gohugoio/hugo/commit/0dbeac80) [@bep](https://github.com/bep) [#10671](https://github.com/gohugoio/hugo/issues/10671) - sass: Remove some unused leftover code [`b99d073`](https://github.com/gohugoio/hugo/commit/b99d073c) [@bep](https://github.com/bep) - resources/sass: Remove debug statements [`e965cb6`](https://github.com/gohugoio/hugo/commit/e965cb67) [@jmooring](https://github.com/jmooring) [#10470](https://github.com/gohugoio/hugo/issues/10470) - page: Move the cache double check right after the lock [`586fea0`](https://github.com/gohugoio/hugo/commit/586fea0d) [@bep](https://github.com/bep) - page: Add some concurrency to the building of the related page index [`fa2d7ad`](https://github.com/gohugoio/hugo/commit/fa2d7adf) [@bep](https://github.com/bep) [#10711](https://github.com/gohugoio/hugo/issues/10711) - related: Adjust benchmark [`4346987`](https://github.com/gohugoio/hugo/commit/4346987f) [@bep](https://github.com/bep) - tocss: Simplify the hugo:vars type handling [`ecf3cd5`](https://github.com/gohugoio/hugo/commit/ecf3cd51) [@bep](https://github.com/bep) [#10632](https://github.com/gohugoio/hugo/issues/10632) - Adjust tests for GO 1.20 [`6abd15e`](https://github.com/gohugoio/hugo/commit/6abd15e7) [@bep](https://github.com/bep) [#10691](https://github.com/gohugoio/hugo/issues/10691) - tpl/internal: Sync Go template src to Go 1.20 [`094135f`](https://github.com/gohugoio/hugo/commit/094135ff) [@bep](https://github.com/bep) [#10691](https://github.com/gohugoio/hugo/issues/10691) - Add page fragments support to Related [`90da766`](https://github.com/gohugoio/hugo/commit/90da7664) [@bep](https://github.com/bep) [#10711](https://github.com/gohugoio/hugo/issues/10711) [#9339](https://github.com/gohugoio/hugo/issues/9339) [#10725](https://github.com/gohugoio/hugo/issues/10725) - related: Adjust benchmark [`0afec0a`](https://github.com/gohugoio/hugo/commit/0afec0a9) [@bep](https://github.com/bep) - related: Add benchmark [`28540ed`](https://github.com/gohugoio/hugo/commit/28540ed1) [@bep](https://github.com/bep) - tpl/collections: Improve error message in Index [`9af78d1`](https://github.com/gohugoio/hugo/commit/9af78d11) [@bep](https://github.com/bep) - Make the HTML collector parsing more robust [`d33a7eb`](https://github.com/gohugoio/hugo/commit/d33a7ebc) [@bep](https://github.com/bep) [#10698](https://github.com/gohugoio/hugo/issues/10698) - tpl/strings: Add strings.ContainsNonSpace [`fce0890`](https://github.com/gohugoio/hugo/commit/fce08904) [@bep](https://github.com/bep) - publisher: Add benchmark [`4f4a1c0`](https://github.com/gohugoio/hugo/commit/4f4a1c00) [@bep](https://github.com/bep) - Update CONTRIBUTING.md [`e2cfc3d`](https://github.com/gohugoio/hugo/commit/e2cfc3d5) [@bep](https://github.com/bep) - Only invoke a given cached partial once [`4ef9baf`](https://github.com/gohugoio/hugo/commit/4ef9baf5) [@bep](https://github.com/bep) [#4086](https://github.com/gohugoio/hugo/issues/4086) [#9588](https://github.com/gohugoio/hugo/issues/9588) #### Dependency Updates - Revert "build(deps): bump gocloud.dev from 0.24.0 to 0.28.0 ([#10610](https://github.com/gohugoio/hugo/issues/10610))" [`db9f74d`](https://github.com/gohugoio/hugo/commit/db9f74d2) [@bep](https://github.com/bep) [#10770](https://github.com/gohugoio/hugo/issues/10770) - build(deps): bump github.com/tdewolff/parse/v2 from 2.6.4 to 2.6.5 [`4d36b99`](https://github.com/gohugoio/hugo/commit/4d36b99a) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/mattn/go-isatty from 0.0.16 to 0.0.17 [`807237b`](https://github.com/gohugoio/hugo/commit/807237bc) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump golang.org/x/image [`79b03b3`](https://github.com/gohugoio/hugo/commit/79b03b3f) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump golang.org/x/net from 0.4.0 to 0.7.0 [`4bf91b9`](https://github.com/gohugoio/hugo/commit/4bf91b97) [@dependabot](https://github.com/dependabot)\[bot] - Revert "build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.114.0" [`2a364cc`](https://github.com/gohugoio/hugo/commit/2a364cca) [@bep](https://github.com/bep) - deps: Upgrade github.com/yuin/goldmark v1.5.3 => v1.5.4 [`3fb2417`](https://github.com/gohugoio/hugo/commit/3fb2417c) [@jmooring](https://github.com/jmooring) [#10661](https://github.com/gohugoio/hugo/issues/10661) - build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.114.0 [`87c78bd`](https://github.com/gohugoio/hugo/commit/87c78bd3) [@dependabot](https://github.com/dependabot)\[bot] - deps: Upgrade github.com/alecthomas/chroma v2.4.0 => v2.5.0 [`69c369e`](https://github.com/gohugoio/hugo/commit/69c369e1) [@jmooring](https://github.com/jmooring) [#9890](https://github.com/gohugoio/hugo/issues/9890) [#10692](https://github.com/gohugoio/hugo/issues/10692) - build(deps): bump github.com/kyokomi/emoji/v2 from 2.2.10 to 2.2.11 [`dd37163`](https://github.com/gohugoio/hugo/commit/dd37163f) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump gocloud.dev from 0.24.0 to 0.28.0 ([#10610](https://github.com/gohugoio/hugo/issues/10610)) [`c3a59a7`](https://github.com/gohugoio/hugo/commit/c3a59a7d) [@dependabot](https://github.com/dependabot)\[bot] [#9778](https://github.com/gohugoio/hugo/issues/9778) #### Documentation - docs: Another fix related docs example [`d5601e8`](https://github.com/gohugoio/hugo/commit/d5601e83) [@bep](https://github.com/bep) - docs: Fix related docs example [`cedd04d`](https://github.com/gohugoio/hugo/commit/cedd04db) [@bep](https://github.com/bep) - cods: Regen docs helper [`a56b907`](https://github.com/gohugoio/hugo/commit/a56b9071) [@bep](https://github.com/bep) - Move the Related doc counter to prevent a race [`5c317c5`](https://github.com/gohugoio/hugo/commit/5c317c55) [@bep](https://github.com/bep) [#10768](https://github.com/gohugoio/hugo/issues/10768) - Update README.md [`93ed6e4`](https://github.com/gohugoio/hugo/commit/93ed6e44) [@bep](https://github.com/bep) #### Build Setup - build: Update to Go 1.20 [`4801e2e`](https://github.com/gohugoio/hugo/commit/4801e2e8) [@bep](https://github.com/bep) [#10691](https://github.com/gohugoio/hugo/issues/10691) - snap: Install dart-sass-embedded for 32-bit ARM (armhf) too [`76c6140`](https://github.com/gohugoio/hugo/commit/76c6140c) [@anthonyfok](https://github.com/anthonyfok) - snap: Add read access for ~/.gitconfig.local and ~/.config/git/\* too [`d4482e8`](https://github.com/gohugoio/hugo/commit/d4482e8b) [@anthonyfok](https://github.com/anthonyfok) [#10337](https://github.com/gohugoio/hugo/issues/10337) ### [`v0.110.0`](https://github.com/gohugoio/hugo/releases/tag/v0.110.0) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.109.0...v0.110.0) #### Note - Make readFile return nil when file not found (note) [`3c51625`](https://github.com/gohugoio/hugo/commit/3c51625c) [@bep](https://github.com/bep) [#9620](https://github.com/gohugoio/hugo/issues/9620) - Make hugo.toml the new config.toml [`f38a2fb`](https://github.com/gohugoio/hugo/commit/f38a2fbd) [@bep](https://github.com/bep) [#8979](https://github.com/gohugoio/hugo/issues/8979) #### Bug fixes - Fix permalinks issue with repeated sections [`671f64b`](https://github.com/gohugoio/hugo/commit/671f64b2) [@bep](https://github.com/bep) [#10377](https://github.com/gohugoio/hugo/issues/10377) - Fix HEAD method in resources.GetRemote [`f13531e`](https://github.com/gohugoio/hugo/commit/f13531e6) [@bep](https://github.com/bep) [#10604](https://github.com/gohugoio/hugo/issues/10604) - Fix order when reading custom headers in resources.GetRemote [`b5d4850`](https://github.com/gohugoio/hugo/commit/b5d48506) [@bep](https://github.com/bep) [#10616](https://github.com/gohugoio/hugo/issues/10616) - resource: Fix Go Doc vs .Data.Integrity [`fbc3e08`](https://github.com/gohugoio/hugo/commit/fbc3e08c) [@bep](https://github.com/bep) #### Improvements - related: Handly \[]any [`d595419`](https://github.com/gohugoio/hugo/commit/d5954190) [@bep](https://github.com/bep) [#10624](https://github.com/gohugoio/hugo/issues/10624) - tpl/strings: Add findRESubmatch [`2fb40ec`](https://github.com/gohugoio/hugo/commit/2fb40ece) [@bep](https://github.com/bep) [#10594](https://github.com/gohugoio/hugo/issues/10594) - config/security: Add GO\w+ (e.g. GOROOT) to the default allowed list [`c6b3887`](https://github.com/gohugoio/hugo/commit/c6b38876) [@bep](https://github.com/bep) [#10429](https://github.com/gohugoio/hugo/issues/10429) - Preserve front matter slice value types (e.g. int) [`21af5b3`](https://github.com/gohugoio/hugo/commit/21af5b35) [@bep](https://github.com/bep) [#10624](https://github.com/gohugoio/hugo/issues/10624) - Make hugo.toml the new config.toml [`f38a2fb`](https://github.com/gohugoio/hugo/commit/f38a2fbd) [@bep](https://github.com/bep) [#8979](https://github.com/gohugoio/hugo/issues/8979) - Add fill HTTP Response info into .Data in resources.GetRemote [`6a579eb`](https://github.com/gohugoio/hugo/commit/6a579eba) [@bep](https://github.com/bep) [#10604](https://github.com/gohugoio/hugo/issues/10604) - tpl/compare: Sort special float values as string [`f95fd57`](https://github.com/gohugoio/hugo/commit/f95fd57a) [@acclassic](https://github.com/acclassic) [#10389](https://github.com/gohugoio/hugo/issues/10389) - tpl/diagrams: Move Goat to its own file [`e754d5c`](https://github.com/gohugoio/hugo/commit/e754d5cb) [@bep](https://github.com/bep) - Update CONTRIBUTING.md [`002cd52`](https://github.com/gohugoio/hugo/commit/002cd528) [@bep](https://github.com/bep) - Update CONTRIBUTING.md [`a76c405`](https://github.com/gohugoio/hugo/commit/a76c405d) [@bep](https://github.com/bep) #### Dependency Updates - deps: Upgrade github.com/evanw/esbuild v0.15.18 => v0.17.0 [`6e9fa9e`](https://github.com/gohugoio/hugo/commit/6e9fa9e0) [@bep](https://github.com/bep) [#10536](https://github.com/gohugoio/hugo/issues/10536) #### Documentation - dos: Regen CLI docs [`19e9605`](https://github.com/gohugoio/hugo/commit/19e96056) [@bep](https://github.com/bep) - docs: Regen docshelper [`80e8bd3`](https://github.com/gohugoio/hugo/commit/80e8bd3b) [@bep](https://github.com/bep) - Update README.md [`c4f3a46`](https://github.com/gohugoio/hugo/commit/c4f3a46c) [@bep](https://github.com/bep) - Misc doc, code refactoring to improve documentation [`e402d91`](https://github.com/gohugoio/hugo/commit/e402d91e) [@bep](https://github.com/bep) - Update README.md [`c0a03a2`](https://github.com/gohugoio/hugo/commit/c0a03a2a) [@bep](https://github.com/bep) #### Build Setup - Remove reference to Goreleaser in code comment [`dd6d0a6`](https://github.com/gohugoio/hugo/commit/dd6d0a6d) [@omarkohl](https://github.com/omarkohl) ### [`v0.109.0`](https://github.com/gohugoio/hugo/releases/tag/v0.109.0) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.108.0...v0.109.0) <img src="https://user-images.githubusercontent.com/394382/209377043-7c5e2506-a4a2-46c1-83af-9a77756563a9.png" width=40% height=40% align=right> Hugo `v0.109.0` is the last release of 2022 – and with that we're wishing all of you a very merry Christmas and a prosperous new year\[^1]. #### Notable new features ##### Pass variables to SCSS/SASS Hugo has had great SCSS/SASS support, but passing variables (e.g. theme colours from config) down to the transpiler has been much harder than it should. In Hugo `v0.109.0` we added a new [vars option](https://gohugo.io/hugo-pipes/scss-sass/#options) and you can finally just do: ```handlebars {{ $vars := dict "color1" "blue" "color2" "green" "font_size" "24px" }} {{ $opts := (dict "transpiler" "dartsass" "outputStyle" "compressed" "vars" $vars ) }} {{ $r := resources.Get "scss/main.scss" | toCSS $opts }} ``` And then in the SCSS file: ```scss @use "hugo:vars" as v; p { color: v.$color1; font-size: v.$font-size; } ``` More examples [here](https://discourse.gohugo.io/t/initialize-sass-variables-from-hugo-templates/42053/). ##### Hugo Module Workspaces Workspace support was added in [Go 1.18](https://go.dev/blog/get-familiar-with-workspaces), and in this release Hugo finally gets solid support for it. A common use case for a workspace is to simplify local development of a site with its theme modules. A workspace can be configured in a `*.work` file and activated with the [module.workspace](https://gohugo.io/hugo-modules/configuration/) setting, which for this use is commonly controlled via the `HUGO_MODULE_WORKSPACE` OS environment variable. See the [hugo.work](https://github.com/gohugoio/hugoDocs/blob/master/hugo.work) file in the Hugo Docs repo for an example: go 1.19 use . use ../gohugoioTheme Using the `use` directive, list all the modules you want to work on, pointing to its relative location. As in the example above, it's recommended to always include the main project (the ".") in the list. With that you can start the Hugo server with that workspace enabled: HUGO_MODULE_WORKSPACE=hugo.work hugo server --ignoreVendorPaths "**" The `--ignoreVendorPaths` flag is added above to ignore any of the vendored dependencies inside `_vendor`. If you don't use vendoring, you don't need that flag. But now the server is set up watching the files and directories in the workspace and you can see your local edits reloaded. ##### Breadcrumbs We have added a new `.Ancestors` method on `Page` that walks up the tree to the home page. With this, breadcrumbs templates can be greatly simplified: ```handlebars <ol> <ul> {{- range .Ancestors.Reverse }} <li><a href="{{ .Permalink }}">{{ .Title }}</a></li> {{- end }} <li class="active" aria-current="page"> <a href="{{ .Permalink }}">{{ .Title }}</a> </li> </ul> </ol> ``` ##### The path to /public now available in PostCSS So you can do `process.env.HUGO_PUBLISHDIR` in your `postcss.config.js` to figure out where Hugo publishes its files. Note that the value will always be an absolute file path and will point to a directory on disk even when running `hugo server` in memory mode. If you write to this folder from PostCSS when running the server, you could run the server with one of these flags: hugo server --renderToDisk hugo server --renderStaticToDisk #### Note - modules: Make the module.workspace=off as default (note) [`0d4b17d`](https://github.com/gohugoio/hugo/commit/0d4b17d4) [@bep](https://github.com/bep) [#10553](https://github.com/gohugoio/hugo/issues/10553) - release: Add a note section in release notes [`3afaca7`](https://github.com/gohugoio/hugo/commit/3afaca75) [@bep](https://github.com/bep) - helpers: Allow at signs in UnicodeSanitize (note) [`2d217cb`](https://github.com/gohugoio/hugo/commit/2d217cba) [@jmooring](https://github.com/jmooring) [#10548](https://github.com/gohugoio/hugo/issues/10548) - Also consider wrapped errors when checking for file IsNotExist errors [`ad20598`](https://github.com/gohugoio/hugo/commit/ad205987) [@bep](https://github.com/bep) [#10534](https://github.com/gohugoio/hugo/issues/10534) #### Bug fixes - If you use the legacy `libsass` transpiler in `toCSS` and uses the cached build to avoid having the extended version installed on the CI server, you need to rebuild those assets and commit them to source control (e.g. with `hugo --gc`). - tpl/resources: Fix data race in ToCSS [`aa2c724`](https://github.com/gohugoio/hugo/commit/aa2c7241) [@bep](https://github.com/bep) [#10542](https://github.com/gohugoio/hugo/issues/10542) - tocss: Fix unquote case with double quotes [`5d5f0a2`](https://github.com/gohugoio/hugo/commit/5d5f0a23) [@septs](https://github.com/septs) [#10555](https://github.com/gohugoio/hugo/issues/10555) - resources/js: Fix some import discrepancies between Hugo and ESBuild [`b54de1b`](https://github.com/gohugoio/hugo/commit/b54de1bd) [@bep](https://github.com/bep) [#10527](https://github.com/gohugoio/hugo/issues/10527) - parser/metadecoders: Fix spelling [`e0e63f3`](https://github.com/gohugoio/hugo/commit/e0e63f35) [@lacamera](https://github.com/lacamera) #### Improvements - Adjust "you need the extended version" error message [`180dfeb`](https://github.com/gohugoio/hugo/commit/180dfeba) [@bep](https://github.com/bep) - resource/page: Slight adjustment of Page.Ancestors [`eb0c8f9`](https://github.com/gohugoio/hugo/commit/eb0c8f9d) [@bep](https://github.com/bep) [#10567](https://github.com/gohugoio/hugo/issues/10567) - resource/page: Add Page.Ancestors [`3a21618`](https://github.com/gohugoio/hugo/commit/3a216186) [@septs](https://github.com/septs) [#10567](https://github.com/gohugoio/hugo/issues/10567) - Annotate test assertions [`7183232`](https://github.com/gohugoio/hugo/commit/71832328) [@jmooring](https://github.com/jmooring) - hugolib: Exclude non-linkable pages from translations map [`37ab1cf`](https://github.com/gohugoio/hugo/commit/37ab1cf1) [@jmooring](https://github.com/jmooring) [#9073](https://github.com/gohugoio/hugo/issues/9073) - Add HUGO_PUBLISHDIR to the Node environment [`59af05c`](https://github.com/gohugoio/hugo/commit/59af05ca) [@bep](https://github.com/bep) [#10554](https://github.com/gohugoio/hugo/issues/10554) - Revert "tpl/tplimpl: Use https in sitemap templates" [`4989da6`](https://github.com/gohugoio/hugo/commit/4989da65) [@jmooring](https://github.com/jmooring) - tocss: Add some more test cases [`effa6a4`](https://github.com/gohugoio/hugo/commit/effa6a42) [@bep](https://github.com/bep) [#10555](https://github.com/gohugoio/hugo/issues/10555) - Allow "fast render mode" even if --disableLiveReload is set [`d20d265`](https://github.com/gohugoio/hugo/commit/d20d2651) [@bep](https://github.com/bep) [#10561](https://github.com/gohugoio/hugo/issues/10561) - tocss: Add vars option [`41a080b`](https://github.com/gohugoio/hugo/commit/41a080b2) [@bep](https://github.com/bep) [#10555](https://github.com/gohugoio/hugo/issues/10555) - modules: Improve "module workspace" not found error [`eda1e72`](https://github.com/gohugoio/hugo/commit/eda1e720) [@bep](https://github.com/bep) - modules: Adjust watch logic vs workspace use definitions [`330fa89`](https://github.com/gohugoio/hugo/commit/330fa894) [@bep](https://github.com/bep) - Add any configured Go Workspace file to the config watcher [`6db5274`](https://github.com/gohugoio/hugo/commit/6db52748) [@bep](https://github.com/bep) [#10556](https://github.com/gohugoio/hugo/issues/10556) - parser/metadecoders: Remove superflous cast in test [`17055d1`](https://github.com/gohugoio/hugo/commit/17055d1f) [@bep](https://github.com/bep) - parser/metadecoders: Simplify nil check in Unmarshal [`2a81a49`](https://github.com/gohugoio/hugo/commit/2a81a494) [@bep](https://github.com/bep) - parser/metadecoders: Add empty /data JSON file as empty map [`e30d711`](https://github.com/gohugoio/hugo/commit/e30d711c) [@acclassic](https://github.com/acclassic) [#8601](https://github.com/gohugoio/hugo/issues/8601) - tpl/openapi3: Wrap \*kopenapi3.T [`87e898a`](https://github.com/gohugoio/hugo/commit/87e898a1) [@bep](https://github.com/bep) - github: Use ruby/setup-ruby [`d894269`](https://github.com/gohugoio/hugo/commit/d8942698) [@bep](https://github.com/bep) [#10517](https://github.com/gohugoio/hugo/issues/10517) - tpl/tplimpl: Use https in sitemap templates [`3fd0b78`](https://github.com/gohugoio/hugo/commit/3fd0b784) [@jmooring](https://github.com/jmooring) [#10515](https://github.com/gohugoio/hugo/issues/10515) #### Dependency Updates - build(deps): bump golang.org/x/tools from 0.3.0 to 0.4.0 [`7874b96`](https://github.com/gohugoio/hugo/commit/7874b968) [@dependabot](https://github.com/dependabot)\[bot] #### Documentation - docs: Regen docs helper JSON [`10bb29d`](https://github.com/gohugoio/hugo/commit/10bb29d7) [@bep](https://github.com/bep) - tpl: Improve template funcs GoDoc [`cd1ed56`](https://github.com/gohugoio/hugo/commit/cd1ed563) [@bep](https://github.com/bep) #### Build Setup - github: Update to Dart Sass 1.56.2 [`c9354d5`](https://github.com/gohugoio/hugo/commit/c9354d54) [@bep](https://github.com/bep) \[^1]: We're working on some bigger and even more exiting Hugo features that will be ready early next year. Stay tuned! ### [`v0.108.0`](https://github.com/gohugoio/hugo/releases/tag/v0.108.0) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.107.0...v0.108.0) With Hugo `v0.108.0` you can render standalone Markdown images without a surrounding paragraph. Both the HTML- and CommonMark-specification defines image as an inline element. For Markdown, this has meant that if you put an image on its own (not *inlined* in another paragraph), it would be wrapped in `<p></p>` tags, even if you provide your own [Render Hook Template](https://gohugo.io/templates/render-hooks/). Now you can get by this annoyance by setting `markup.goldmark.parser.wrapStandAloneImageWithinParagraph = false` ```toml [markup] [markup.goldmark] [markup.goldmark.parser] wrapStandAloneImageWithinParagraph = false [markup.goldmark.parser.attribute] block = true ``` In the above we have also enabled attribute support for Markdown blocks to illustrate another nice side effect of this; it's now possible to use Markdown attributes (e.g. CSS classes) on standalone images: ```md This is an inline image: ![Inline Image](/inline.jpg). Some more text. ![Block Image](/block.jpg) {.blue} ``` The images in the above Markdown example would, given the hook template below, be rendered wrapped in a `figure` element with the `blue` CSS class applied in the latter example. ```handlebars {{ if .IsBlock }}<figure class="{{ .Attributes.class }}"><img src="{{ .Destination | safeURL }}" alt="{{ .Text }}" /></figure> {{ else }}<img src="{{ .Destination | safeURL }}" alt="{{ .Text }}" />{{ end }} ``` Two new fields are added to the render context passed to image render hooks: - `IsBlock`: Returns true if this is a standalone image and the config option [markup.goldmark.parser.wrapStandAloneImageWithinParagraph](https://gohugo.io/getting-started/configuration-markup/#goldmark) is disabled. - `Ordinal`: Zero-based ordinal for all the images in the current document. #### Bug fixes - common/hugio: Fix multiWriteCloser.Close [`5067775`](https://github.com/gohugoio/hugo/commit/5067775a) [@bep](https://github.com/bep) [#10505](https://github.com/gohugoio/hugo/issues/10505) - tpl/collections: Fix some index cases where the indices given is a slice and be more lenient with nil inputs [`d373774`](https://github.com/gohugoio/hugo/commit/d373774c) [@bep](https://github.com/bep) [#10489](https://github.com/gohugoio/hugo/issues/10489) #### Improvements - Make the hugo env non verbose output slightly more verbose [`f97544a`](https://github.com/gohugoio/hugo/commit/f97544a8) [@bep](https://github.com/bep) - Add dart-sass-embedded version info to hugo env -v [`d8efe08`](https://github.com/gohugoio/hugo/commit/d8efe085) [@bep](https://github.com/bep) - tpl/embedded: Make Open Graph's series optional [`b82b547`](https://github.com/gohugoio/hugo/commit/b82b547a) [@razonyang](https://github.com/razonyang) - dartsass: Add sourceMapIncludeSources option [`e93138d`](https://github.com/gohugoio/hugo/commit/e93138df) [@bep](https://github.com/bep) - github: Update Dart Sass Embedded to 1.56.1 [`7d16c3c`](https://github.com/gohugoio/hugo/commit/7d16c3c0) [@bep](https://github.com/bep) - markup/goldmark: Add removeSurroundingParagraph for Markdown images [`63126c6`](https://github.com/gohugoio/hugo/commit/63126c63) [@bep](https://github.com/bep) [#8362](https://github.com/gohugoio/hugo/issues/8362) [#10492](https://github.com/gohugoio/hugo/issues/10492) [#10494](https://github.com/gohugoio/hugo/issues/10494) [#10501](https://github.com/gohugoio/hugo/issues/10501) - tpl/tplimpl: Allow alternate comment syntax [`0b976d2`](https://github.com/gohugoio/hugo/commit/0b976d2b) [@jmooring](https://github.com/jmooring) [#10495](https://github.com/gohugoio/hugo/issues/10495) - resources: Increase timeout for http.Client [`a49e51f`](https://github.com/gohugoio/hugo/commit/a49e51fd) [@dirtymew](https://github.com/dirtymew) [#10478](https://github.com/gohugoio/hugo/issues/10478) - config/security: Add CI env var to whitelist [`dc44bca`](https://github.com/gohugoio/hugo/commit/dc44bca9) [@septs](https://github.com/septs) - tpl: Use consistent delimiter spacing in examples [`b8d5c37`](https://github.com/gohugoio/hugo/commit/b8d5c378) [@jmooring](https://github.com/jmooring) #### Dependency Updates - deps: Upgrade github.com/bep/godartsass v0.15.0 => v0.16.0 [`f5b5b71`](https://github.com/gohugoio/hugo/commit/f5b5b71c) [@bep](https://github.com/bep) - build(deps): bump github.com/getkin/kin-openapi from 0.109.0 to 0.110.0 [`50549c8`](https://github.com/gohugoio/hugo/commit/50549c86) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/evanw/esbuild from 0.15.16 to 0.15.18 [`535ea8c`](https://github.com/gohugoio/hugo/commit/535ea8cc) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump golang.org/x/text from 0.4.0 to 0.5.0 [`8bbec42`](https://github.com/gohugoio/hugo/commit/8bbec426) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/evanw/esbuild from 0.15.15 to 0.15.16 [`0bfa293`](https://github.com/gohugoio/hugo/commit/0bfa293d) [@dependabot](https://github.com/dependabot)\[bot] - deps: Upgrade github.com/bep/godartsass v0.14.0 => v0.15.0 [`83080df`](https://github.com/gohugoio/hugo/commit/83080df6) [@bep](https://github.com/bep) #### Documentation - docs: Add basic doc for wrapStandAloneImageWithinParagraph etc. [`de9c554`](https://github.com/gohugoio/hugo/commit/de9c5542) [@bep](https://github.com/bep) [#10492](https://github.com/gohugoio/hugo/issues/10492) - tpl: Misco GoDoc improvements [`7d5e3ab`](https://github.com/gohugoio/hugo/commit/7d5e3ab8) [@bep](https://github.com/bep) - docs: Regen docs helper [`75f782a`](https://github.com/gohugoio/hugo/commit/75f782a5) [@bep](https://github.com/bep) ### [`v0.107.0`](https://github.com/gohugoio/hugo/releases/tag/v0.107.0) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.106.0...v0.107.0) This release is mostly interesting if you do code highlighting. We fixed a bottle neck which should show a significant performance boost for sites using code highlighting. Hugo's [gohugo.io](https://gohugo.io/) docs site builds ~20% faster. Also, Chroma, the highlighting library, is upgraded to [v2.4.0](https://github.com/alecthomas/chroma/releases/tag/v2.4.0) with new lexers and lots of improvements. #### Bug fixes - hugo/parser: Fix shortcode boolean param parsing [`00fe7e0`](https://github.com/gohugoio/hugo/commit/00fe7e04) [@jmooring](https://github.com/jmooring) [#10451](https://github.com/gohugoio/hugo/issues/10451) #### Improvements - Add a cache for lexers.Get [`7855b47`](https://github.com/gohugoio/hugo/commit/7855b47f) [@bep](https://github.com/bep) - markup/goldmark: Improve benchmark [`34d1150`](https://github.com/gohugoio/hugo/commit/34d1150d) [@bep](https://github.com/bep) - commands: Create assets directory with new site [`85e2ac1`](https://github.com/gohugoio/hugo/commit/85e2ac1a) [@jmooring](https://github.com/jmooring) [#10460](https://github.com/gohugoio/hugo/issues/10460) #### Dependency Updates - build(deps): bump github.com/getkin/kin-openapi from 0.108.0 to 0.109.0 [`6a004b8`](https://github.com/gohugoio/hugo/commit/6a004b8d) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/evanw/esbuild from 0.15.14 to 0.15.15 [`0923622`](https://github.com/gohugoio/hugo/commit/09236224) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/frankban/quicktest from 1.14.3 to 1.14.4 [`7477672`](https://github.com/gohugoio/hugo/commit/74776726) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump golang.org/x/tools from 0.2.0 to 0.3.0 [`63f7f0f`](https://github.com/gohugoio/hugo/commit/63f7f0ff) [@dependabot](https://github.com/dependabot)\[bot] - deps: Upgrade github.com/alecthomas/chroma/v2 v2.4.0 [`bcb62d8`](https://github.com/gohugoio/hugo/commit/bcb62d89) [@bep](https://github.com/bep) ### [`v0.106.0`](https://github.com/gohugoio/hugo/releases/tag/v0.106.0) [Compare Source](https://github.com/gohugoio/hugo/compare/v0.105.0...v0.106.0) #### Bug fixes - Fix taxonomy weight sort regression [`52ea07d`](https://github.com/gohugoio/hugo/commit/52ea07d2) [@bep](https://github.com/bep) [#10406](https://github.com/gohugoio/hugo/issues/10406) - tlp/resources: resources.Get returns nil when given empty string [`db945a6`](https://github.com/gohugoio/hugo/commit/db945a6e) [@shifterbit](https://github.com/shifterbit) - tpl/internal: Sync go_templates [`f6ab955`](https://github.com/gohugoio/hugo/commit/f6ab9553) [@bep](https://github.com/bep) [#10411](https://github.com/gohugoio/hugo/issues/10411) #### Dependency Updates - build(deps): bump github.com/pelletier/go-toml/v2 from 2.0.4 to 2.0.6 [`bafb389`](https://github.com/gohugoio/hugo/commit/bafb389b) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/evanw/esbuild from 0.15.13 to 0.15.14 [`cdd83bf`](https://github.com/gohugoio/hugo/commit/cdd83bf3) [@dependabot](https://github.com/dependabot)\[bot] - deps: Update the libweb version string [`e00220a`](https://github.com/gohugoio/hugo/commit/e00220a0) [@bep](https://github.com/bep) - deps: Upgrade github.com/bep/gowebp v0.1.0 => v0.2.0 [`a662dda`](https://github.com/gohugoio/hugo/commit/a662ddae) [@bep](https://github.com/bep) - build(deps): bump github.com/yuin/goldmark from 1.5.2 to 1.5.3 [`fe08d35`](https://github.com/gohugoio/hugo/commit/fe08d35f) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/spf13/afero from 1.9.2 to 1.9.3 [`4b675dd`](https://github.com/gohugoio/hugo/commit/4b675ddd) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/getkin/kin-openapi from 0.107.0 to 0.108.0 [`24eaa29`](https://github.com/gohugoio/hugo/commit/24eaa290) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/clbanning/mxj/v2 from 2.5.6 to 2.5.7 [`58a98c7`](https://github.com/gohugoio/hugo/commit/58a98c77) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump golang.org/x/net from 0.1.0 to 0.2.0 [`900904f`](https://github.com/gohugoio/hugo/commit/900904fd) [@dependabot](https://github.com/dependabot)\[bot] - build(deps): bump github.com/evanw/esbuild from 0.15.12 to 0.15.13 [`24eca0c`](https://github.com/gohugoio/hugo/commit/24eca0cb) [@dependabot](https://github.com/dependabot)\[bot] #### Documentation - docs: Regen CLI docs [`0a019a1`](https://github.com/gohugoio/hugo/commit/0a019a1a) [@bep](https://github.com/bep) - docs: Regenerate docs helper [`9f7fb0a`](https://github.com/gohugoio/hugo/commit/9f7fb0a7) [@bep](https://github.com/bep) - Add Go 1.16+ install method to README [`60e0e2c`](https://github.com/gohugoio/hugo/commit/60e0e2c1) [@vgnh](https://github.com/vgnh) - readme: Update ToC [`13adf3e`](https://github.com/gohugoio/hugo/commit/13adf3e0) [@vgnh](https://github.com/vgnh) </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).

renovator force-pushed renovate/gohugoio-hugo-0.x from b867fcc1c5 to 8610858955

2023-05-23 08:34:06 +00:00

Compare

renovator changed title from ~~chore(deps): update dependency gohugoio/hugo to v0.111.3~~ to chore(deps): update dependency gohugoio/hugo to v0.112.0

2023-05-23 08:34:07 +00:00

renovator force-pushed renovate/gohugoio-hugo-0.x from 8610858955 to 532ceccc60

2023-05-23 18:03:41 +00:00

Compare

renovator changed title from ~~chore(deps): update dependency gohugoio/hugo to v0.112.0~~ to chore(deps): update dependency gohugoio/hugo to v0.112.1

2023-05-23 18:03:42 +00:00

renovator force-pushed renovate/gohugoio-hugo-0.x from 532ceccc60 to dce2ccd22c

2023-05-24 11:34:03 +00:00

Compare

renovator changed title from ~~chore(deps): update dependency gohugoio/hugo to v0.112.1~~ to chore(deps): update dependency gohugoio/hugo to v0.112.2

2023-05-24 11:34:04 +00:00

renovator force-pushed renovate/gohugoio-hugo-0.x from dce2ccd22c to 91925faba1

2023-05-24 15:04:12 +00:00

Compare

renovator changed title from ~~chore(deps): update dependency gohugoio/hugo to v0.112.2~~ to chore(deps): update dependency gohugoio/hugo to v0.112.3

2023-05-24 15:04:14 +00:00

renovator force-pushed renovate/gohugoio-hugo-0.x from 91925faba1 to 558e513fa5

2023-05-28 13:34:06 +00:00

Compare

renovator changed title from ~~chore(deps): update dependency gohugoio/hugo to v0.112.3~~ to chore(deps): update dependency gohugoio/hugo to v0.112.4

2023-05-28 13:34:07 +00:00

renovator force-pushed renovate/gohugoio-hugo-0.x from 558e513fa5 to ad55e5c84b

2023-05-29 08:04:07 +00:00

Compare

renovator changed title from ~~chore(deps): update dependency gohugoio/hugo to v0.112.4~~ to chore(deps): update dependency gohugoio/hugo to v0.112.5

2023-05-29 08:04:08 +00:00

xoxys merged commit b87891ca43 into main

2023-05-29 10:33:01 +00:00

xoxys referenced this issue from a commit

2023-05-29 10:33:02 +00:00

chore(deps): update dependency gohugoio/hugo to v0.112.5 (#92)

xoxys deleted branch renovate/gohugoio-hugo-0.x

2023-05-29 10:33:02 +00:00

Sign in to join this conversation.

No reviewers

No Label

No Milestone

No Assignees

1 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: container/hugo#92