Hugo 0.96 update notes

Hugo 0.96.0 was published last weekend with two new features and many smaller changes and fixes under the hood. Here is a quick overview of the release.

New features

Vertical merging of content mounts

Under this title hides a useful feature for Hugo Modules that mount content directories. This new feature lets you mount multiple module directories into each other to fill in missing translations of the first mount.

• TOML
• YAML
• JSON
• (click to select format)

1[module]
2[[module.mounts]]
3  lang = 'de'
4  source = 'content/de'
5  target = 'content'
6[[module.mounts]]
7  lang = 'de'
8  source = 'content/en'
9  target = 'content'

1module:
2  mounts:
3  - lang: de
4    source: content/de
5    target: content
6  - lang: de
7    source: content/en
8    target: content

 1{
 2   "module": {
 3      "mounts": [
 4         {
 5            "lang": "de",
 6            "source": "content/de",
 7            "target": "content"
 8         },
 9         {
10            "lang": "de",
11            "source": "content/en",
12            "target": "content"
13         }
14      ]
15   }
16}

The interesting thing to note here is, that the merging is not happening from the left to the right, but the other way around. People coming from other programming languages might expect, that everything in the second module mount is overriding things in the first one, if there is already content under the same name available. In fact it is the other way around in Hugo (or Go as such). Following module mounts will fill missing parts of the first mount, or, in the widest sense, everything in the last module will be overridden by the contents of each successive previous module. The first mount wins.

HTTP error objects for Get* functions

Previously errors in the .GetRemote function only returned the status of the request. This was not very helpful for fully featured APIs that would in error cases return more data. This has now been rectified and errors return an additional .Data object with the common HTTP response values. This lets the developer have more control over the error handling. Errors due to rate limiting for instance will be easily detectable now.

• go-html-template

 1{{ with $result := resources.GetRemote $url }}
 2  {{ with .Err }}
 3  <ul>
 4    <li>Error: {{ .Error }}
 5      <ul>
 6      {{ range .Data }}
 7        <li>StatusCode: {{ .StatusCode }}</li>
 8        <li>Status: {{ .Status }}</li>
 9        <li>Body: {{ .Body }}</li>
10        <li>TransferEncoding: {{ .TransferEncoding }}</li>
11        <li>ContentLength: {{ .ContentLength }}</li>
12        <li>ContentType: {{ .ContentType }}</li>
13      {{ end }}
14      </ul>
15    </li>
16  </ul>
17  {{ else }}
18    {{ with .Content | unmarshal }}
19      {{ . }}
20    {{ end }}
21  {{ end }}
22{{ end }}

Adding content type to hmac function

The hmac function creates a cryptographic hash from input by using a key.

With this release you can set an optional argument to define, what the function returns, either hex (default) or binary format.

• go-html-template

1{{ hmac "sha256" $key $message "hex" }}
2{{ hmac "sha256" $key $message "binary" }}

Better validation of image processing options

In older releases it was possible to pass invalid sizing options to resize, crop, fill and fit in the image processing options. From this release on an error will be returned on the CLI. resize requires either a width or a height and crop, fill and fit require both, width and height.

@debug and @warn in SCSS

Logging commands in Hugo’s dartsass implementation were ignored until now. This has been fixed and @warn and @deprecated in your SCSS will result in warning in the CLI as well as @debug in info levels in the log. To see @debug messages you will have to run hugo with the --verbose flag.

Deprecations

• .File.Extension on the page object was deprecated. This was never documented. Use File.Ext instead.

Under the hood

Bep continued to add features new in Go 1.18 to this release. All else are smaller fixes and improvements. You can find all changes on Github.