Hugo 0.22.1 fixes a couple of issues reported after the 0.22 release Monday. Most importantly a fix for detecting regular subfolders below the root-sections.

Also, we forgot to adapt the permalink settings with support for nested sections, which made that feature less useful than it could be.

With this release you can configure permalinks with sections like this:

First level only:

[permalinks]
blog = ":section/:title"

Nested (all levels):

[permalinks]
blog = ":sections/:title"

Fixes

• Fix section logic for root folders with subfolders a30023f5 @bep #3586
• Support sub-sections in permalink settings 1f26420d @bep #3580
• Adjust rlimit to 64000 ff54b6bd @bep #3582
• Make error on setting rlimit a warning only 629e1439 @bep #3582
• Revert: Remove the rlimit tweaking on macOS 26aa06a3 @bep #3582

Automated with @goreleaser
Built with go version go1.8.3 darwin/amd64

Hugo 0.22 brings nested sections, by popular demand and a long sought after feature (#465). We are still low on documentation for this great feature, but @bep has been kind enough to accompany his implementation with a demo site.

This release represents 58 contributions by 10 contributors to the main Hugo code base. Since last release Hugo has gained 420 stars and 2 additional themes.

@bep still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. But also a big shoutout to @bogem, @moorereason, and @onedrawingperday for their ongoing contributions. And as always big thanks to @digitalcraftsman for his relentless work on keeping the documentation and the themes site in pristine condition.

Hugo now has:

• 17576+ stars
• 455+ contributors
• 165+ themes

Other Highlights

.Site.GetPage can now also be used to get regular pages (#2844):

{{ (.Site.GetPage "page" "blog" "mypost.md" ).Title }}

Also, considerable work has been put into writing automated benchmark tests for the site builds, and we're happy to report that although this release comes with fundamental structural changes, this version is -- in general -- even faster than the previous. It’s quite a challenge to consistently add significant new functionality and simultaneously maintain the stellar performance Hugo is famous for.

Notes

.Site.Sections is replaced. We have reworked how sections work in Hugo, they can now be nested and are no longer taxonomies. If you use the old collection, you should get detailed upgrade instructions in the log when you run hugo. For more information, see this demo site.

Enhancements

Templates

• Add uint support to In b82cd82f @moorereason
• Support interfaces in union 204c3a9e @moorereason #3411
• Add uniq function e28d9aa4 @adiabatic
• Handle template.HTML and friends in ToInt 4113693a @moorereason #3308

Core

• Make the RSS feed use the date for the node it represents f1da5a15 @bep #2708
• Enable nested sections b3968939 @bep #465
• Add test for "no 404" in sitemap 8aaec644 @bep #3563
• Support regular pages in .Site.GetPage e0c2e798 @bep #2844
  #3082

Performance

• Add site building benchmarks 8930e259 @bep #3535
• Add a cache to GetPage which makes it much faster 50d11138 @bep
• Speed up GetPage fbb78b89 @bep #3503
• Add BenchmarkFrontmatterTags 3d9c4f51 @bep #3464
• Add benchSite.sh to make it easy to run Hugo performance benchmarks d74452cf @bep
• Cache language config 4aff2b6e @bep
• Temporarily revert to BurntSushi for TOML front matter handling; it is currently much faster 0907a5c1 @bep #3541 #3464
• Add a simple partitioned lazy cache 87203139 @bep

Other

• Add noindex tag to HTML generated by Hugo aliases d5ab7f08 @onedrawingperday
• Update Go versions bde807bd @bep
• Remove the rlimit tweaking on macOS bcd32f10 @bep #3512

Docs

• Rewrite “Archetypes” article @davidturnbull #3543
• Remove Unmaintaned Frontends from Tools. f41f7282 @onedrawingperday

Fixes

Core

• Improve live-reload on directory structure changes making removal of directories or pasting new content directories into  /content just work fe901b81 @bep #3570
• Respect disableKinds=["sitemap"] 69d92dc4 @bep #3544
• Fix disablePathToLower regression 5be04486 @bep #3374
• Fix ref/relref issue with duplicate base filenames 612f6e3a @bep #2507

Docs

• Fix parameter name in YouTube shortcode section 37e37877 @zivbk1

Automated with @goreleaser
Built with go version go1.8.3 darwin/amd64

Hugo 0.21 brings full support for shortcodes per Output Format (#3220), the last vital piece of that puzzle. This is especially useful for Google AMP with its many custom media tags.

This release represents 126 contributions by 29 contributors to the main Hugo code base. Since last main release Hugo has gained 850 stars and 7 additional themes.

Hugo now has:

• 17156+ stars
• 457+ contributors
• 163+ themes

@bep leads the Hugo development with a significant amount of contributions, but also a big shoutout to @moorereason, @bogem, and @munnerz for their ongoing contributions. And as always a big thanks to @digitalcraftsman for his relentless work on keeping the documentation and the themes site in pristine condition.

Other Highlights

On a more technical side, @moorereason and @bep have introduced namespaces for Hugo's many template funcs (#3042 ). There are so many now, and adding more into that big pile would be a sure path toward losing control. Now they are nicely categorised into namespaces with its own tests and examples, with an API that the documentation site can use to make sure it is correct and up-to-date.

Notes

• The deprecated .Extension, .Now and .TargetPath will now ERROR 544f0a63 @bep
• The config settings and flags disable404, disableRSS, disableSitemap, disableRobotsTXT are now deprecated. Use disableKinds. 5794a265 @bep #3345

Enhancements

Templates

• Log a WARNING on wrong usage of IsSet 38661c17 @moorereason #3092
• Add support for ellipsed paginator navigator, making paginators with lots of pages more compact b6ea492b @bep #3466
• Add support for interfaces to intersect f1c29b01 @moorereason #1952
• Add NumFmt function 93b3b138 @moorereason #1444
• Add template function namespaces #3418 #3042 @moorereason @bep
• Add translation links to the default sitemap template 90d3fbf1 @rayjolt #2569
• Allow text partials in HTML templates and the other way around 1cf29200 @bep #3273

Output

• Refactor site rendering with an "output format context". In this release, this is used for shortcode handling only, but this paves the way for future niceness 1e4d082c @bep #3397 2bcbf104 @bep #3220

Core

• Handle shortcode per Output Format af72db80 @bep #3220
• Improve shortcode error message 58d9cbd3 @bep
• Avoid index.md in /index/index.html fea4fd86 @bep #3396
• Make missing GitInfo a WARNING 5ad2f176 @bep #3376
• Prevent decoding pageParam in common cases e98f885b @bogem
• Ignore non-source files on partial rebuild b5b6e81c @xofyarg #3325
• Log WARNING only on unknown /data files ab692e73 @bep #3361
• Avoid processing the same notify event twice 3b677594 @bep
• Only show rssURI deprecation WARNING if it is actually set cfd3af8e @bep #3319

Docs

• Add documentation on slug translation 635b3bb4 @xavib
• Replace cdn.mathjax.org with cdnjs.cloudflare.com 4b637ac0 @takuti
• Add notes about some output format behaviour 162d3a58 @jpatters
• Add txtpen as alternative commenting service 7cdc244a @rickyhan

Other

• Embed Page in WeightedPage ebf677a5 @bep #3435
• Improve the detection of untranslated strings a40d1f6e @bogem #2607
• Make first letter of the Hugo commands flags' usage lowercase f0f69d03 @bogem
• Import Octopress image tag in Jekyll importer 5f3ad1c3 @buynov

Fixes

Templates

• Do not lower case template names 6d2ea0f7 @bep #3333

Output

• Fix output format mixup in example 10287263 @bep #3481
• Fix base theme vs project base template logic 077005e5 @bep #3323

Core

• Render 404 in default language only 154e18dd @mitchchn #3075
• Fix RSSLink vs RSS Output Format e682fcc6 @bep #3450
• Add default config for ignoreFiles, making that option work when running in server mode 42f4ce15 @chaseadamsio
• Fix output formats override when no outputs definition given 6e2f2dd8 @bep #3447
• Fix handling of zero-length files 0e87b18b @bep #3355
• Must recreate Paginator on live-reload 45c74526 @bep #3315

Docs

• Fix incorrect path in templates/list 27e88154 [@MunifTanjim](...

This just fixes an issue with the release scripts, no change in the binaries.

Hugo now has:

• 16782+ stars
• 458+ contributors
• 156+ themes

Fix

• Push the tag before goreleaser is run 3682bf52 @bep #3405

Automated with @goreleaser
Built with go version go1.8.1 darwin/amd64

There have been some shouting on discuss.gohugo.io about some broken sites after the release of Hugo 0.20. This release reintroduces the old behaviour, making /my-blog-post/index.md work as expected.

Hugo now has:

• 16675+ stars
• 456+ contributors
• 156+ themes

Fixes

• Avoid index.md in /index/index.html #3396
• Make missing GitInfo a WARNING b30ca4be @bep #3376
• Fix some of the fpm fields for deb 3bd1d057 @anthonyfok

Automated with @goreleaser
Built with go version go1.8.1 darwin/amd64

This is a bug-fix release which fixes the version number of 0.20.4 (which wrongly shows up as 0.21-DEV) (#3388).

Automated with @goreleaser
Built with go version go1.8.1 darwin/amd64

This is the second bug-fix release of the day, fixing a couple of issues related to the new release scripts.

Hugo now has:

• 16626+ stars
• 457+ contributors
• 156+ themes

Fixes

• Fix statically linked binaries 275bcf56 @munnerz #3382
• Filename change in Hugo 0.20.3 binaries #3385
• Fix version calculation cb3c6b6f @bep

Automated with @goreleaser
Built with go version go1.8.1 darwin/amd64

This is a bug-fix release with one important fix. But it also adds some harness around GoReleaser to automate the Hugo release process. Big thanks to @caarlos0 for great and super-fast support fixing issues along the way.

Hugo now has:

• 16619+ stars
• 458+ contributors
• 156+ themes

Enhancement

• Automate the Hugo release process 550eba64 @bep #3358

Fix

• Fix handling of zero-length files 9bf5c381 @bep #3355

Automated with @goreleaser
Built with go version go1.8.1 linux/amd64

0.20.2 April 16th 2017

Hugo 0.20.2 adds support for plain text partials included into HTML templates. This was a side-effect of the big new Custom Output Format feature in 0.20, and while the change was intentional and there was an ongoing discussion about fixing it in #3273, it did break some themes. There were valid workarounds for these themes, but we might as well get it right.

The most obvious use case for this is inline CSS styles, which you now can do without having to name your partials with a html suffix.

A simple example:

In layouts/partials/mystyles.css:

body {
	background-color: {{ .Param "colors.main" }}
}

Then in config.toml (note that by using the .Param lookup func, we can override the color in a page’s front matter if we want):

[params]
[params.colors]
main = "green"
text = "blue"

And then in layouts/partials/head.html (or the partial used to include the head section into your layout):

<head>
    <style type="text/css">
    {{ partial "mystyles.css" . | safeCSS }}
    </style>
</head>

Of course, 0.20 also made it super-easy to create external CSS stylesheets based on your site and page configuration. A simple example:

Add “CSS” to your home page’s outputs list, create the template /layouts/index.css using Go template syntax for the dynamic parts, and then include it into your HTML template with:

{{ with  .OutputFormats.Get "css" }}
<link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink |  safeURL }}">
{{ end }}`

0.20.1 April 13th 2017

Hugo 0.20.1 is a bug fix release, fixing some important regressions introduced in 0.20 a couple of days ago:

• Fix logic for base template in work dir vs in the theme #3323
• camelCased templates (partials, shortcodes etc.) not found #3333
• Live-reload fails with _index.md with paginator #3315
• rssURI WARNING always shown #3319