hugo/docs/content/release-notes/0.21-relnotes.md

---

date: 2017-05-22 title: 0.21

Hugo `0.21` brings full support for shortcodes per [Output Format](https://gohugo.io/extras/output-formats/) ([#3220](https://github.com/gohugoio/hugo/issues/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
• Fixed incorrect specification of directory structure a28fbca6 @TejasQ
• Fix bash command in tutorials/github-pages-blog c9976155 @hansott
• Fix .Data.Pages range in example b5e32eb6 @hxlnt

Other

• Fix data race in live-reload close, avoiding some rare panics 355736ec @bep #2625
• Skip .git directories in file scan 94b5be67 @bogem #3468