2013-07-06 19:36:30 -04:00
---
2014-05-29 18:42:05 -04:00
aliases:
- /doc/release-notes/
- /meta/release-notes/
2016-03-12 01:27:34 -05:00
lastmod: 2016-03-12
2014-05-29 18:42:05 -04:00
date: 2013-07-01
2014-04-23 03:00:11 -04:00
menu:
2014-05-27 18:32:57 -04:00
main:
2014-05-29 18:42:05 -04:00
parent: about
title: Release Notes
weight: 10
2013-07-08 17:57:01 -04:00
---
2015-08-23 08:20:14 -04:00
2016-10-07 09:48:39 -04:00
## **0.17.0** October 7th 2016
2016-10-07 11:16:48 -04:00
Hugo is going global with our 0.17 release. We put a lot of thought into how we could extend Hugo
2016-10-07 09:48:39 -04:00
to support multilingual websites with the most simple and elegant experience. Hugo's multilingual
2016-10-07 11:16:48 -04:00
capabilities rival the best web and documentation software, but Hugo's experience is unmatched.
If you have a single language website, the simple Hugo experience you already love is unchanged.
Adding additional languages to your website is simple and straightforward. Hugo has been completely
internally rewritten to be multilingual aware with translation and internationalization features
2016-10-07 09:48:39 -04:00
embedded throughout Hugo.
Hugo continues its trend of each release being faster than the last. It's quite a challenge to consistently add
2016-10-07 11:16:48 -04:00
significant new functionality and simultaneously dramatically improve performance. {{< gh " @ bep " > }} has made it
his personal mission to apply the Go mantra of "Enable more. Do less" to Hugo. Hugo's consistent improvement
is a testament to his brilliance and his dedication to his craft. Hugo additionally benefits from the
2016-10-07 09:48:39 -04:00
performance improvements from the Go team in the Go 1.7 release.
This release represents **over 300 contributions by over 70 contributors** to
the main Hugo code base. Since last release Hugo has **gained 2000 stars, 50 new
contributors and 20 additional themes.**
Hugo now has:
* 12,000 stars on GitHub
* 370+ contributors
* 110+ themes
2016-10-07 11:16:48 -04:00
{{< gh " @ bep " > }} continues to lead the project with the lionshare of contributions
and reviews. A special thanks to {{< gh " @ bep " > }} and {{< gh " @ abourget " > }} for their
considerable work on multilingual support.
A big welcome to newcomers {{< gh " @ MarkDBlackwell " > }}, {{< gh " @ bogem " > }} and
2016-10-07 09:48:39 -04:00
{{< gh " @ g3wanghc " > }} for their critical contributions.
### Highlights
**Multilingual Support:**
Hugo now supports multiple languages side-by-side. A single site can now have multiple languages rendered with
full support for translation and i18n.
**Performance:**
Hugo is faster than ever! Hugo 0.17 is not only our fastest release, it's also the most efficient.
Hugo 0.17 is **nearly twice as fast as Hugo 0.16** and uses about 10% less memory.
This means that the same site will build in nearly half the time it took with Hugo 0.16.
For the first time Hugo sites are averaging well under 1ms per rendered content.
**Docs overhaul:**
2016-10-07 11:16:48 -04:00
This release really focused on improving the documentation. [Gohugo.io ](http://gohugo.io ) is
2016-10-07 09:48:39 -04:00
more accurate and complete than ever.
2016-10-07 12:43:34 -04:00
**Support for macOS Sierra**
2016-10-07 09:48:39 -04:00
### New Features
* Multilingual support {{< gh 2303 > }}
* Allow content expiration {{< gh 2137 > }}
* New templates functions:
* `querify` function to generate query strings inside templates {{< gh 2257 > }}
* `htmlEscape` and `htmlUnescape` template functions {{< gh 2287 > }}
* `time` converts a timestamp string into a time.Time structure {{< gh 2329 > }}
### Enhancements
* Render the shortcodes as late as possible {{< gh 0xed0985404db4630d1b9d3ad0b7e41fb186ae0112 > }}
* Remove unneeded casts in page.getParam {{< gh 2186 > }}
* Automatic page date fallback {{< gh 2239 > }}
* Enable safeHTMLAttr {{< gh 2234 > }}
* Add TODO list support for markdown {{< gh 2296 > }}
* Make absURL and relURL accept any type {{< gh 2352 > }}
* Suppress 'missing static' error {{< gh 2344 > }}
* Make summary, wordcount etc. more efficient {{< gh 2378 > }}
* Better error reporting in `hugo convert` {{< gh 2440 > }}
* Reproducible builds thanks to govendor {{< gh 2461 > }}
### Fixes
* Fix shortcode in markdown headers {{< gh 2210 > }}
* Explicitly bind livereload to hugo server port {{< gh 2205 > }}
* Fix Emojify for certain text patterns {{< gh 2198 > }}
* Normalize file name to NFC {{< gh 2259 > }}
* Ignore emacs temp files {{< gh 2266 > }}
* Handle symlink change event {{< gh 2273 > }}
* Fix panic when using URLize {{< gh 2274 > }}
* `hugo import jekyll` : Fixed target path location check {{< gh 2293 > }}
* Return all errors from casting in templates {{< gh 2356 > }}
* Fix paginator counter on x86-32 {{< gh 2420 > }}
* Fix half-broken self-closing shortcodes {{< gh 2499 > }}
****
2016-06-06 08:37:59 -04:00
## **0.16.0** June 6th 2016
2016-03-12 01:27:34 -05:00
2016-06-02 16:48:32 -04:00
Hugo 0.16 is our best and biggest release ever. The Hugo community has
outdone itself with continued performance improvements,
[beautiful themes ](http://themes.gohugo.io ) for all types of sites from project
sites to documentation to blogs to portfolios, and increased stability.
2016-03-12 01:27:34 -05:00
2016-06-02 16:48:32 -04:00
This release represents **over 550 contributions by over 110 contributors** to
2016-10-07 09:48:39 -04:00
the main Hugo code base. Since last release Hugo has **gained 3500 stars, 90
2016-06-02 16:48:32 -04:00
contributors and 23 additional themes.**
This release celebrates 3 years since {{< gh " @ spf13 " > }} wrote the first lines
of Hugo. During those 3 years Hugo has accomplished some major milestones
including...
* 10,000+ stars on GitHub
* 320+ contributors
* 90+ themes
* 1000s of happy websites
* Many subprojects like {{< gh "@ spf13 / cobra " > }}, {{< gh "@ spf13 / viper " > }} and
{{< gh " @ spf13 / afero " > }} which have experienced broad usage across the Go
ecosystem.
2016-10-07 11:16:48 -04:00
2016-06-06 08:37:59 -04:00
{{< gh " @ bep " > }} led the development of Hugo for the 3rd consecutive release
2016-06-03 14:53:33 -04:00
with nearly half of the contributions to 0.16 in addition to his considerable
contributions as lead maintainer. {{< gh " @ anthonyfok " > }}, {{< gh
"@DigitalCraftsman" >}}, {{< gh " @ MooreReason " > }} all made significant
contributions. A special thanks to {{< gh " @ abourget " > }} for his considerable
2016-06-03 16:54:18 -04:00
work on multilingual support. Due to its broad impact we wanted to spend more
2016-06-03 14:53:33 -04:00
time testing it and it will be included in Hugo's next release.
2016-06-02 16:48:32 -04:00
### Highlights
**Partial Builds:** Prior to this release Hugo would always reread and rebuild
the entire site. This release introduces support for reactive site building
2016-06-04 15:44:38 -04:00
while watching (`hugo server`). Hugo will watch the filesystem for changes and
2016-06-02 16:48:32 -04:00
only re-read the changed files. Depending on the files change Hugo will
intelligently re-render only the needed portion of the site. Performance gains
depend on the operation performed and size of the site. In our testing build
times decreased anywhere from 10% to 99%.
2016-06-03 16:54:18 -04:00
**Template Improvements:** Template improvements continue to be a mainstay of each Hugo release. Hugo 0.16 adds support for the new `block` keyword introduced in Go 1.6 -- think base templates with default sections -- as well as many new template functions.
2016-06-02 16:48:32 -04:00
2016-06-03 18:14:32 -04:00
**Polish:** As Hugo matures releases will inevitably contain fewer huge new features. This release represents hundreds of small improvements across ever facet of Hugo which will make for a much better experience for all of our users. Worth mentioning here is the curious bug where live reloading didn't work in some editors on OS X, including the popular TextMate 2. This is now fixed. Oh, and now any error will exit with an error code, a big thing for automated deployments.
2016-03-12 01:27:34 -05:00
### New Features
2016-04-20 17:50:43 -04:00
* Support reading configuration variables from the OS environment {{< gh 2090 > }}
2016-03-12 01:27:34 -05:00
* Add emoji support {{< gh 1892 > }}
* Add `themesDir` option to configuration {{< gh 1556 > }}
* Add support for Go 1.6 `block` keyword in templates {{< gh 1832 > }}
* Partial static sync {{< gh 1644 > }}
* Source file based relative linking (a la Github) {{< gh 0x0f6b334b6715253b030c4e783b88e911b6e53e56 > }}
2016-10-07 09:48:39 -04:00
* Add `ByLastmod` sort function to pages. {{< gh 0xeb627ca16de6fb5e8646279edd295a8bf0f72bf1 > }}
2016-04-22 15:37:36 -04:00
* New templates functions:
2016-10-07 11:16:48 -04:00
* `readFile` {{< gh 1551 > }}
2016-04-22 15:37:36 -04:00
* `countwords` and `countrunes` {{< gh 1440 > }}
* `default` {{< gh 1943 > }}
* `hasPrefix` {{< gh 1243 > }}
2016-06-20 14:21:10 -04:00
* `humanize` {{< gh 1818 > }}
2016-04-22 15:37:36 -04:00
* `jsonify` {{< gh 0x435e996c4fd48e9009ffa9f83a19fb55f0777dbd > }}
* `md5` and `sha1` {{< gh 1932 > }}
* `replaceRE` {{< gh 1845 > }}
* `findRE` {{< gh 2048 > }}
* `shuffle` {{< gh 1942 > }}
* `slice` {{< gh 1902 > }}
* `plainify` {{< gh 1915 > }}
2016-03-12 01:27:34 -05:00
### Enhancements
2016-06-02 16:48:32 -04:00
* Hugo now exits with error code on any error. This is a big thing for
automated deployments. {{< gh 740 > }}
2016-03-12 01:27:34 -05:00
* Print error when `/index.html` is zero-length {{< gh 947 > }}
2016-06-02 16:48:32 -04:00
* Enable dirname and filename bash autocompletion for more flags {{< gh
0x666ddd237791b56fd048992dca9a27d1af50a10e>}}
2016-03-12 01:27:34 -05:00
* Improve error handling in commands {{< gh 1502 > }}
* Add sanity checks for `hugo import jekyll` {{< gh 1625 > }}
* Add description to `Page.Params` {{< gh 1484 > }}
* Add async version of Google Analytics internal template {{< gh 1711 > }}
* Add autostart option to YouTube shortcode {{< gh 1784 > }}
* Set Date and Lastmod for main home page {{< gh 1903 > }}
* Allow URL with extension in frontmatter {{< gh 1923 > }}
2016-06-02 16:48:32 -04:00
* Add list support in Scratch {{< gh
0xeaba04e82bdfc5d4c29e970f11b4aab9cc0efeaa>}}
2016-03-12 01:27:34 -05:00
* Add file option to gist shortcode {{< gh 1955 > }}
* Add config layout and content directory CLI options {{< gh 1698 > }}
2016-06-02 16:48:32 -04:00
* Add boolean value comparison to `where` template function {{< gh
0xf3c74c9db484c8961e70cb3458f9e41e7832fa12>}}
2016-04-21 05:27:12 -04:00
* Do not write to to cache when `ignoreCache` is set {{< gh 2067 > }}
2016-04-21 05:23:54 -04:00
* Add option to disable rendering of 404 page {{< gh 2037 > }}
* Mercurial is no longer needed to build Hugo {{< gh 2062 > }}
2016-04-21 05:27:12 -04:00
* Do not create `robots.txt` by default {{< gh 2049 > }}
2016-06-02 16:48:32 -04:00
* Disable syntax guessing for PygmentsCodeFences by default. To enable syntax
guessing again, add the following to your config file:
`PygmentsCodeFencesGuessSyntax = true` {{< gh 2034 > }}
2016-04-21 05:23:54 -04:00
* Make `ByCount` sort consistently {{< gh 1930 > }}
* Add `Scratch` to shortcode {{< gh 2000 > }}
2016-06-02 16:48:32 -04:00
* Add support for symbolic links for content, layout, static, theme {{< gh 1855
>}}
* Add '+' as one of the valid characters in URLs specified in the front matter
{{< gh 1290 > }}
* Make alias redirect output URLs relative when `RelativeURLs = true` {{< gh
2093 >}}
2016-06-06 08:37:59 -04:00
* Hugo injects meta generator tag on homepage if missing {{< gh
2182 >}}
2016-03-12 01:27:34 -05:00
### Fixes
2016-04-22 13:03:46 -04:00
* Fix file change watcher for TextMate 2 and friends on OS X {{< gh 1053 > }}
* Make dynamic reloading of config file reliable on all platform {{< gh 1684 > }}
* Hugo now works on Linux/arm64 {{< gh 1772 > }}
2016-04-12 12:39:07 -04:00
* `plainIDAnchors` now defaults to `true` {{< gh 2057 > }}
2016-03-12 01:27:34 -05:00
* Win32 and ARM builds fixed {{< gh 1716 > }}
* Copy static dir files without theme's static dir {{< gh 1656 > }}
* Make `noTimes` command flag work {{< gh 1657 > }}
* Change most global CLI flags into local ones {{< gh 1624 > }}
* Remove transformation of menu URLs {{< gh 1239 > }}
* Do not fail on unknown Jekyll file {{< gh 1705 > }}
* Use absolute path when editing with editor {{< gh 1589 > }}
* Fix hugo server "Watching for changes" path display {{< gh 1721 > }}
* Do not strip special characters out of URLs {{< gh 1292 > }}
2016-10-24 14:56:00 -04:00
* Fix `RSSLink` when uglyURLs are enabled {{< gh 175 > }}
2016-03-12 01:27:34 -05:00
* Get BaseURL from viper in server mode {{< gh 1821 > }}
* Fix shortcode handling in RST {{< gh 1904 > }}
* Use default sitemap configuration for homepage {{< gh 1304 > }}
* Exit if specific port is unavailable in server mode {{< gh 1901 > }}
2016-04-21 05:23:54 -04:00
* Fix regression in "section menus for lazy blogger" {{< gh 2065 > }}
2016-03-12 01:27:34 -05:00
2016-06-02 16:48:32 -04:00
****
2015-11-24 16:51:01 -05:00
## **0.15.0** November 25, 2015
The v0.15.0 Hugo release brings a lot of polish to Hugo. Exactly 6 months after
the 0.14 release, Hugo has seen massive growth and changes. Most notably, this
is Hugo's first release under the Apache 2.0 license. With this license change
we hope to expand the great community around Hugo and make it easier for our
many users to contribute. This release represents over **377 contributions by
87 contributors** to the main Hugo repo and hundreds of improvements to the
libraries Hugo uses. Hugo also launched a [new theme
showcase](http://themes.gohugo.io) and participated in
2015-12-02 15:11:24 -05:00
[Hacktoberfest ](https://hacktoberfest.digitalocean.com ).
2015-11-24 16:51:01 -05:00
Hugo now has:
2015-12-19 06:32:06 -05:00
* 6700 (+2700) stars on GitHub
2015-11-24 16:51:01 -05:00
* 235 (+75) contributors
* 65 (+30) themes
**Template Improvements:** This release takes Hugo to a new level of speed and
usability. Considerable work has been done adding features and performance to
the template system which now has full support of Ace, Amber and Go Templates.
**Hugo Import:** Have a Jekyll site, but dreaming of porting it to Hugo? This
release introduces a new `hugo import jekyll` command that makes this easier
than ever.
**Performance Improvements:** Just when you thought Hugo couldn't get any faster,
Hugo continues to improve in speed while adding features. Notably Hugo 0.15
introduces the ability to render and serve directly from memory resulting in
30%+ lower render times.
Huge thanks to all who participated in this release. A special thanks to
2015-11-25 10:01:22 -05:00
{{< gh " @ bep " > }} who led the development of Hugo this release again,
{{< gh " @ anthonyfok " > }},
{{< gh " @ eparis " > }},
{{< gh " @ tatsushid " > }} and
2015-12-19 06:32:06 -05:00
{{< gh " @ DigitalCraftsman " > }}.
2015-11-24 16:51:01 -05:00
2015-12-19 06:32:06 -05:00
### New features
2015-11-25 10:01:22 -05:00
* new `hugo import jekyll` command. {{< gh 1469 > }}
* The new `Param` convenience method on `Page` and `Node` can be used to get the most specific parameter value for a given key. {{< gh 1462 > }}
2015-11-24 16:51:01 -05:00
* Several new information elements have been added to `Page` and `Node` :
2015-11-25 10:01:22 -05:00
* `RuneCount` : The number of [runes ](http://blog.golang.org/strings ) in the content, excluding any whitespace. This may be a good alternative to `.WordCount` for Japanese and other CJK languages where a word-split by spaces makes no sense. {{< gh 1266 > }}
2015-11-24 16:51:01 -05:00
* `RawContent` : Raw Markdown as a string. One use case may be of embedding remarkjs.com slides.
* `IsHome` : tells the truth about whether you're on the home page or not.
2015-12-19 06:32:06 -05:00
### Improvements
2015-11-24 15:13:02 -05:00
* `hugo server` now builds ~30%+ faster by rendering to memory instead of disk. To get the old behavior, start the server with `--renderToDisk=true` .
2015-11-24 16:51:01 -05:00
* Hugo now supports dynamic reloading of the config file when watching.
2015-11-25 10:01:22 -05:00
* We now use a custom-built `LazyFileReader` for reading file contents, which means we don't read media files in `/content` into memory anymore -- and file reading is now performed in parallel on multicore PCs. {{< gh 1181 > }}
* Hugo is now built with `Go 1.5` which, among many other improvements, have fixed the last known data race in Hugo. {{< gh 917 > }}
* Paginator now also supports page groups. {{< gh 1274 > }}
2015-11-24 16:51:01 -05:00
* Markdown improvements:
2015-11-25 10:01:22 -05:00
* Hugo now supports GitHub-flavoured markdown code fences for highlighting for `md` -files (Blackfriday rendered markdown) and `mmark` files (MMark rendered markdown). {{< gh 362 1258 > }}
2015-11-24 16:51:01 -05:00
* Several new Blackfriday options are added:
* Option to disable Blackfriday's `Smartypants` .
2015-11-25 10:01:22 -05:00
* Option for Blackfriday to open links in a new window/tab. {{< gh 1220 > }}
* Option to disable Blackfriday's LaTeX style dashes {{< gh 1231 > }}
2015-11-24 16:51:01 -05:00
* Definition lists extension support.
* `Scratch` now has built-in `map` support.
2015-11-25 10:01:22 -05:00
* We now fall back to `link title` for the default page sort. {{< gh 1299 > }}
2015-11-24 16:51:01 -05:00
* Some notable new configuration options:
2015-11-25 10:01:22 -05:00
* `IgnoreFiles` can be set with a list of Regular Expressions that matches files to be ignored during build. {{< gh 1189 > }}
* `PreserveTaxonomyNames` , when set to `true` , will preserve what you type as the taxonomy name both in the folders created and the taxonomy `key` , but it will be normalized for the URL. {{< gh 1180 > }}
2015-11-24 16:51:01 -05:00
* `hugo gen` can now generate man files, bash auto complete and markdown documentation
* Hugo will now make suggestions when a command is mistyped
2015-11-25 10:01:22 -05:00
* Shortcodes now have a boolean `.IsNamedParams` property. {{< gh 1597 > }}
2015-11-24 16:51:01 -05:00
2015-12-19 06:32:06 -05:00
### New Template Features
2015-11-24 16:51:01 -05:00
* All template engines:
2015-12-02 15:11:24 -05:00
* The new `dict` function that could be used to pass maps into a template. {{< gh 1463 > }}
2015-11-09 23:31:52 -05:00
* The new `pluralize` and `singularize` template funcs.
2015-09-25 15:34:32 -04:00
* The new `base64Decode` and `base64Encode` template funcs.
2015-11-25 10:01:22 -05:00
* The `sort` template func now accepts field/key chaining arguments and pointer values. {{< gh 1330 > }}
* Several fixes for `slicestr` and `substr` , most importantly, they now have full `utf-8` -support. {{< gh 1190 1333 1347 > }}
* The new `last` template function allows the user to select the last `N` items of a slice. {{< gh 1148 > }}
* The new `after` func allows the user to select the items after the `Nth` item. {{< gh 1200 > }}
2015-11-20 13:18:38 -05:00
* Add `time.Time` type support to the `where` , `ge` , `gt` , `le` , and `lt` template functions.
2015-11-25 10:01:22 -05:00
* It is now possible to use constructs like `where Values ".Param.key" nil` to filter pages that doesn't have a particular parameter. {{< gh 1232 > }}
* `getJSON` /`getCSV`: Add retry on invalid content. {{< gh 1166 > }}
* The new `readDir` func lists local files. {{< gh 1204 > }}
2015-11-24 19:30:05 -05:00
* The new `safeJS` function allows the embedding of content into JavaScript contexts in Go templates.
2015-11-25 10:01:22 -05:00
* Get the main site RSS link from any page by accessing the `.Site.RSSLink` property. {{< gh 1566 > }}
2015-08-23 08:20:14 -04:00
* Ace templates:
2015-11-25 10:01:22 -05:00
* Base templates now also works in themes. {{< gh 1215 > }}.
* And now also on Windows. {{< gh 1178 > }}
2015-11-24 16:51:01 -05:00
* Full support for Amber templates including all template functions.
2015-11-25 10:01:22 -05:00
* A built-in template for Google Analytics. {{< gh 1505 > }}
* Hugo is now shipped with new built-in shortcodes: {{< gh 1576 > }}
2015-11-24 14:45:54 -05:00
* `youtube` for YouTube videos
* `vimeo` for Vimeo videos
* `gist` for GitHub gists
* `tweet` for Twitter Tweets
* `speakerdeck` for Speakerdeck slides
2015-08-23 08:20:14 -04:00
2014-05-27 18:32:57 -04:00
2015-12-19 06:32:06 -05:00
### Bugfixes
2015-11-25 10:01:22 -05:00
* Fix data races in page sorting and page reversal. These operations are now also cached. {{< gh 1293 > }}
2015-11-24 16:51:01 -05:00
* `page.HasMenuCurrent()` and `node.HasMenuCurrent()` now work correctly in multi-level nested menus.
2015-11-25 10:01:22 -05:00
* Support `Fish and Chips` style section titles. Previously, this would end up as `Fish And Chips` . Now, the first character is made toupper, but the rest are preserved as-is. {{< gh 1176 > }}
* Hugo now removes superfluous p-tags around shortcodes. {{< gh 1148 > }}
2015-11-24 16:51:01 -05:00
2015-12-19 06:32:06 -05:00
### Notices
2015-11-24 16:51:01 -05:00
* `hugo server` will watch by default now.
* Some fields and methods were deprecated in `0.14` . These are now removed, so the error message isn't as friendly if you still use the old values. So please change:
* `getJson` to `getJSON` , `getCsv` to `getCSV` , `safeHtml` to
`safeHTML` , `safeCss` to `safeCSS` , `safeUrl` to `safeURL` , `Url` to `URL` ,
`UrlPath` to `URLPath` , `BaseUrl` to `BaseURL` , `Recent` to `Pages` .
2015-12-19 06:32:06 -05:00
### Known Issues
Using the Hugo v0.15 32-bit Windows or ARM binary, running `hugo server` would crash or hang due to a [memory alignment issue ](https://golang.org/pkg/sync/atomic/#pkg-note-BUG ) in [Afero ](https://github.com/spf13/afero ). The bug was discovered shortly after the v0.15.0 release and has since been [fixed ](https://github.com/spf13/afero/pull/23 ) by {{< gh "@ tpng " > }}. If you encounter this bug, you may either compile Hugo v0.16-DEV from source, or use the following solution/workaround:
* **64-bit Windows users: Please use [hugo_0.15_windows_amd64.zip ](https://github.com/spf13/hugo/releases/download/v0.15/hugo_0.15_windows_amd64.zip )** (amd64 == x86-64). It is only the 32-bit hugo_0.15_windows_386.zip that crashes/hangs (see {{< gh 1621 > }} and {{< gh 1628 > }}).
* **32-bit Windows and ARM users: Please run `hugo server --renderToDisk` as a workaround** until Hugo v0.16 is released (see [“hugo server” returns runtime error on armhf ](https://discuss.gohugo.io/t/hugo-server-returns-runtime-error-on-armhf/2293 ) and {{< gh 1716 > }}).
----
2015-05-23 22:04:12 -04:00
## **0.14.0** May 25, 2015
2015-05-07 16:08:11 -04:00
2015-05-23 22:04:12 -04:00
The v0.14.0 Hugo release brings of the most demanded features to Hugo. The
foundation of Hugo is stabilizing nicely and a lot of polish has been added.
We’ ve expanded support for additional content types with support for AsciiDoc,
Restructured Text, HTML and Markdown. Some of these types depend on external
libraries as there does not currently exist native support in Go. We’ ve tried
to make the experience as seamless as possible. Look for more improvements here
in upcoming releases.
2015-05-09 16:03:45 -04:00
2015-05-23 22:04:12 -04:00
A lot of work has been done to improve the user experience, with extra polish
to the Windows experience. Hugo errors are more helpful overall and Hugo now
can detect if it’ s being run in Windows Explorer and provide additional
instructions to run it via the command prompt.
The Hugo community continues to grow. Hugo has over 4000 stars on github, 165
2015-05-25 11:55:04 -04:00
contributors, 35 themes and 1000s of happy users. It is now the 5th most
2015-05-23 22:04:12 -04:00
popular static site generator (by Stars) and has the 3rd largest contributor
community.
This release represents over **240 contributions by 36 contributors** to the main
Hugo codebase.
2015-11-25 10:01:22 -05:00
Big shout out to {{< gh " @ bep " > }} who led the development of Hugo
this release, {{< gh " @ anthonyfok " > }},
{{< gh " @ eparis " > }},
{{< gh " @ SchumacherFM " > }},
{{< gh " @ RickCogley " > }} &
{{< gh " @ mdhender " > }} for their significant contributions
and {{< gh " @ tatsushid " > }} for his continuous improvements
2015-05-25 11:55:04 -04:00
to the templates. Also a big thanks to all the theme creators. 11 new themes
2015-05-23 22:04:12 -04:00
have been added since last release and the [hugoThemes repo now has previews of
2015-05-25 11:55:04 -04:00
all of
them](https://github.com/spf13/hugoThemes/blob/master/README.md#theme-list).
2015-05-23 22:04:12 -04:00
2015-09-20 21:26:17 -04:00
Hugo also depends on a lot of other great projects. A big thanks to all of our dependencies including:
2015-05-23 22:04:12 -04:00
[cobra ](https://github.com/spf13/cobra ),
2015-08-04 14:00:08 -04:00
[viper ](https://github.com/spf13/viper ),
2015-05-23 22:04:12 -04:00
[blackfriday ](https://github.com/russross/blackfriday ),
[pflag ](https://github.com/spf13/pflag ),
[HugoThemes ](https://github.com/spf13/hugothemes ),
2015-11-04 18:33:03 -05:00
[BurntSushi ](https://github.com/BurntSushi/toml ),
2015-05-23 22:04:12 -04:00
[goYaml ](https://github.com/go-yaml/yaml/tree/v2 ), and the Go standard library.
## New features
2015-08-04 14:00:08 -04:00
* Support for all file types in content directory.
2015-05-23 22:04:12 -04:00
* If dedicated file type handler isn’ t found it will be copied to the destination.
2015-05-09 16:03:45 -04:00
* Add `AsciiDoc` support using external helpers.
2015-08-04 14:00:08 -04:00
* Add experimental support for [`Mmark` ](https://github.com/miekg/mmark ) markdown processor
2015-05-23 22:04:12 -04:00
* Bash autocomplete support via `genautocomplete` command
2015-05-10 10:18:14 -04:00
* Add section menu support for a [Section Menu for "the Lazy Blogger" ]({{< relref "extras/menus.md#section-menu-for-the-lazy-blogger" >}} )
2015-05-23 22:04:12 -04:00
* Add support for `Ace` base templates
* Adding `RelativeURLs = true` to site config will now make all the relative URLs relative to the content root.
2015-05-09 16:03:45 -04:00
* New template functions:
* `getenv`
2015-05-11 12:06:47 -04:00
* The string functions `substr` and `slicestr`
2015-11-25 10:01:22 -05:00
* `seq` , a sequence generator very similar to its Gnu counterpart
2015-05-11 12:06:47 -04:00
* `absURL` and `relURL` , both of which takes the `BaseURL` setting into account
2015-05-23 22:04:12 -04:00
## Improvements
2015-08-04 14:00:08 -04:00
* Highlighting with `Pygments` is now cached to disk -- expect a major speed boost if you use it!
2015-05-23 22:04:12 -04:00
* More Pygments highlighting options, including `line numbers`
* Show help information to Windows users who try to double click on `hugo.exe` .
* Add `bind` flag to `hugo server` to set the interface to which the server will bind
2016-10-24 14:56:00 -04:00
* Add support for `canonifyURLs` in `srcset`
2015-05-23 22:04:12 -04:00
* Add shortcode support for HTML (content) files
* Allow the same `shortcode` to be used with or without inline content
* Configurable RSS output filename
## Bugfixes
* Fix panic with paginator and zero pages in result set.
* Fix crossrefs on Windows.
2015-08-04 14:00:08 -04:00
* Fix `eq` and `ne` template functions when used with a raw number combined with the result of `add` , `sub` etc.
2016-10-24 14:56:00 -04:00
* Fix paginator with uglyURLs
2015-11-25 10:01:22 -05:00
* Fix {{< gh 998 > }}, supporting UTF8 characters in Permalinks.
2015-05-23 22:04:12 -04:00
## Notices
* To get variable and function names in line with the rest of the Go community,
a set of variable and function names has been deprecated: These will still
work in 0.14, but will be removed in 0.15. What to do should be obvious by
the build log; `getJson` to `getJSON` , `getCsv` to `getCSV` , `safeHtml` to
`safeHTML` , `safeCss` to `safeCSS` , `safeUrl` to `safeURL` , `Url` to `URL` ,
`UrlPath` to `URLPath` , `BaseUrl` to `BaseURL` , `Recent` to `Pages` ,
`Indexes` to `Taxonomies` .
2015-05-07 16:08:11 -04:00
2015-12-19 06:32:06 -05:00
----
2015-02-21 22:31:01 -05:00
## **0.13.0** Feb 21, 2015
2015-01-14 07:54:38 -05:00
2015-02-21 22:31:01 -05:00
The v0.13.0 release is the largest Hugo release to date. The release introduced
some long sought after features (pagination, sequencing, data loading, tons of
template improvements) as well as major internal improvements. In addition to
the code changes, the Hugo community has grown significantly and now has over
3000 stars on github, 134 contributors, 24 themes and 1000s of happy users.
2015-01-14 07:54:38 -05:00
2015-02-21 22:31:01 -05:00
This release represents **448 contributions by 65 contributors**
2015-02-10 10:58:20 -05:00
2015-11-25 10:01:22 -05:00
A special shout out to {{< gh " @ bep " > }} and
{{< gh " @ anthonyfok " > }} for their new role as Hugo
2015-02-10 10:58:20 -05:00
maintainers and their tremendous contributions this release.
### New major features
* Support for [data files ](/extras/datafiles/ ) in [YAML ](http://yaml.org/ ),
[JSON ](http://www.json.org/ ), or [TOML ](https://github.com/toml-lang/toml )
2015-11-25 10:01:22 -05:00
located in the `data` directory ({{< gh 885 > }})
2015-02-16 13:50:53 -05:00
* Support for [dynamic content ](/extras/dynamiccontent/ ) by loading JSON & CSV
from remote sources via GetJson and GetCsv in short codes or other layout
2015-11-25 10:01:22 -05:00
files ({{< gh 748 > }})
2015-02-10 10:58:20 -05:00
* [Pagination support ](/extras/pagination/ ) for home page, sections and
2015-11-25 10:01:22 -05:00
taxonomies ({{< gh 750 > }})
2015-02-10 10:58:20 -05:00
* Universal sequencing support
* A new, generic Next/Prev functionality is added to all lists of pages
(sections, taxonomies, etc.)
* Add in-section [Next/Prev ](/templates/variables/ ) content pointers
* `Scratch` -- [a "scratchpad" ](/extras/scratch ) for your node- and page-scoped
variables
2015-02-16 13:50:53 -05:00
* [Cross Reference ](/extras/crossreferences/ ) support to easily link documents
2015-08-04 14:00:08 -04:00
together with the ref and relref shortcodes.
2015-11-25 10:01:22 -05:00
* [Ace ](http://ace.yoss.si/ ) template engine support ({{< gh 541 > }})
2015-02-10 10:58:20 -05:00
* A new [shortcode ](/extras/shortcodes/ ) token of `{{</* */>}}` (raw HTML)
alongside the existing `{{%/* */%}}` (Markdown)
* A top level `Hugo` variable (on Page & Node) is added with various build
information
* Several new ways to order and group content:
* `ByPublishDate`
* `GroupByPublishDate(format, order)`
* `GroupByParam(key, order)`
* `GroupByParamDate(key, format, order)`
* Hugo has undergone a major refactoring, with a new handler system and a
generic file system. This sounds and is technical, but will pave the way for
new features and make Hugo even speedier
### Notable enhancements to existing features
* The [shortcode ](/extras/shortcodes/ ) handling is rewritten for speed and
2015-08-04 14:00:08 -04:00
better error messages.
2015-01-27 21:17:09 -05:00
* Several improvements to the [template functions ](/templates/functions/ ):
2015-02-10 10:58:20 -05:00
* `where` is now even more powerful and accepts SQL-like syntax with the
operators `==` , `eq` ; `!=` , `<>` , `ne` ; `>=` , `ge` ; `>` , `gt` ; `<=` ,
`le` ; `<` , `lt` ; `in` , `not in`
* `where` template function now also accepts dot chaining key argument
(e.g. `"Params.foo.bar"` )
2015-01-14 07:54:38 -05:00
* New template functions:
2015-02-10 10:58:20 -05:00
* `apply`
* `chomp`
* `delimit`
* `sort`
* `markdownify`
2015-08-04 14:00:08 -04:00
* `in` and `intersect`
2015-02-10 10:58:20 -05:00
* `trim`
* `replace`
* `dateFormat`
* Several [configurable improvements related to Markdown
rendering](/overview/configuration/#configure-blackfriday-rendering:a66b35d20295cb764719ac8bd35837ec):
* Configuration of footnote rendering
* Optional support for smart angled quotes, e.g. `"Hugo"` → «Hugo»
* Enable descriptive header IDs
2015-11-25 10:01:22 -05:00
* URLs in XML output is now correctly canonified ({{< gh 725 728 > }}, and part
of {{< gh 789 > }})
2015-02-10 10:58:20 -05:00
### Other improvements
* Internal change to use byte buffer pool significantly lowering memory usage
and providing measurable performance improvements overall
* Changes to docs:
* A new [Troubleshooting ](/troubleshooting/overview/ ) section is added
2015-11-25 10:01:22 -05:00
* It's now searchable through Google Custom Search ({{< gh 753 > }})
2015-02-10 10:58:20 -05:00
* Some new great tutorials:
* [Automated deployments with
Wercker](/tutorials/automated-deployments/)
* [Creating a new theme ](/tutorials/creating-a-new-theme/ )
2015-02-16 13:50:53 -05:00
* [`hugo new` ](/content/archetypes/ ) now copies the content in addition to the front matter
2015-01-14 07:54:38 -05:00
* Improved unit test coverage
* Fixed a lot of Windows-related path issues
* Improved error messages for template and rendering errors
2015-11-25 10:01:22 -05:00
* Enabled soft LiveReload of CSS and images ({{< gh 490 > }})
* Various fixes in RSS feed generation ({{< gh 789 > }})
2015-01-14 07:54:38 -05:00
* `HasMenuCurrent` and `IsMenuCurrent` is now supported on Nodes
* A bunch of [bug fixes ](https://github.com/spf13/hugo/commits/master )
2015-12-19 06:32:06 -05:00
----
2014-04-18 03:23:13 -04:00
2014-09-01 10:00:45 -04:00
## **0.12.0** Sept 1, 2014
A lot has happened since Hugo v0.11.0 was released. Most of the work has been
focused on polishing the theme engine and adding critical functionality to the
templates.
This release represents over 90 code commits from 28 different contributors.
* 10 [new themes ](https://github.com/spf13/hugoThemes ) created by the community
2015-01-27 21:17:09 -05:00
* Fully themable [Partials ](/templates/partials/ )
2014-09-01 10:00:45 -04:00
* [404 template ](/templates/404/ ) support in themes
* [Shortcode ](/extras/shortcodes/ ) support in themes
* [Views ](/templates/views/ ) support in themes
* Inner [shortcode ](/extras/shortcodes/ ) content now treated as Markdown
* Support for header ids in Markdown (# Header {#myid})
2015-01-27 21:17:09 -05:00
* [Where ](/templates/list/ ) template function to filter lists of content, taxonomies, etc.
* [GroupBy ](/templates/list/ ) & [GroupByDate ](/templates/list/ ) methods to group pages
2014-09-01 10:00:45 -04:00
* Taxonomy [pages list ](/taxonomies/methods/ ) now sortable, filterable, limitable & groupable
* General cleanup to taxonomies & documentation to make it more clear and consistent
* [Showcase ](/showcase/ ) returned and has been expanded
* Pretty links now always have trailing slashes
* [BaseUrl ](/overview/configuration/ ) can now include a subdirectory
* Better feedback about draft & future post rendering
2015-01-27 21:17:09 -05:00
* A variety of improvements to [the website ](http://gohugo.io/ )
2014-09-01 10:00:45 -04:00
2015-12-19 06:32:06 -05:00
----
2014-05-28 01:37:33 -04:00
## **0.11.0** May 28, 2014
2014-09-01 10:00:45 -04:00
This release represents over 110 code commits from 29 different contributors.
2014-05-27 18:32:57 -04:00
* Considerably faster... about 3 - 4x faster on average
2015-01-27 21:17:09 -05:00
* [LiveReload ](/extras/livereload/ ). Hugo will automatically reload the browser when the build is complete
* Theme engine w/[Theme Repository](https://github.com/spf13/hugoThemes)
* [Menu system ](/extras/menus/ ) with support for active page
* [Builders ](/extras/builders/ ) to quickly create a new site, content or theme
* [XML sitemap ](/templates/sitemap/ ) generation
* [Integrated Disqus ](/extras/comments/ ) support
* Streamlined [template organization ](/templates/overview/ )
* [Brand new docs site ](http://gohugo.io/ )
2014-05-29 01:00:06 -04:00
* Support for publishDate which allows for posts to be dated in the future
2015-01-27 21:17:09 -05:00
* More [sort ](/content/ordering/ ) options
2014-05-27 18:32:57 -04:00
* Logging support
* Much better error handling
* More informative verbose output
2015-01-27 21:17:09 -05:00
* Renamed Indexes > [Taxonomies ](/taxonomies/overview/ )
* Renamed Chrome > [Partials ](/templates/partials/ )
2014-05-27 18:32:57 -04:00
2015-12-19 06:32:06 -05:00
----
2014-03-01 12:16:36 -05:00
## **0.10.0** March 1, 2014
2014-09-01 10:00:45 -04:00
This release represents over 110 code commits from 29 different contributors.
2015-01-27 21:17:09 -05:00
* [Syntax highlighting ](/extras/highlighting/ ) powered by pygments (**slow**)
* Ability to [sort content ](/content/ordering/ ) many more ways
* Automatic [table of contents ](/extras/toc/ ) generation
* Support for Unicode URLs, aliases and indexes
* Configurable per-section [permalink ](/extras/permalinks/ ) pattern support
* Support for [paired shortcodes ](/extras/shortcodes/ )
* Shipping with some [shortcodes ](/extras/shortcodes/ ) (highlight & figure)
* Adding [canonify ](/extras/urls/ ) option to keep urls relative
* A bunch of [additional template functions ](/layout/functions/ )
* Watching very large sites now works on Mac
* RSS generation improved. Limited to 50 items by default, can limit further in [template ](/layout/rss/ )
* Boolean params now supported in [frontmatter ](/content/front-matter/ )
* Launched website [showcase ](/showcase/ ). Show off your own hugo site!
2014-02-18 18:34:29 -05:00
* A bunch of [bug fixes ](https://github.com/spf13/hugo/commits/master )
2013-07-04 11:32:55 -04:00
2015-12-19 06:32:06 -05:00
----
2014-01-10 21:19:19 -05:00
## **0.9.0** November 15, 2013
2014-09-01 10:00:45 -04:00
This release represents over 220 code commits from 22 different contributors.
2015-01-27 21:17:09 -05:00
* New [command based interface ](/overview/usage/ ) similar to git (`hugo server -s ./`)
2013-11-15 23:47:53 -05:00
* Amber template support
2015-01-27 21:17:09 -05:00
* [Aliases ](/extras/aliases/ ) (redirects)
2013-11-15 23:47:53 -05:00
* Support for top level pages (in addition to homepage)
* Complete overhaul of the documentation site
* Full Windows support
2015-01-27 21:17:09 -05:00
* Better index support including [ordering by content weight ](/content/ordering/ )
2013-11-15 23:47:53 -05:00
* Add params to site config, available in .Site.Params from templates
* Friendlier json support
* Support for html & xml content (with frontmatter support)
2015-01-27 21:17:09 -05:00
* Support for [summary ](/content/summaries/ ) content divider (< code > < !-- more--> </ code > )
* HTML in [summary ](/content/summaries/ ) (when using divider)
* Added ["Minutes to Read" ](/layout/variables/ ) functionality
2013-11-15 23:47:53 -05:00
* Support for a custom 404 page
2013-08-17 08:34:25 -04:00
* Cleanup of how content organization is handled
* Loads of unit and performance tests
* Integration with travis ci
2013-11-15 23:47:53 -05:00
* Static directory now watched and copied on any addition or modification
2013-11-05 00:24:04 -05:00
* Support for relative permalinks
* Fixed watching being triggered multiple times for the same event
* Watch now ignores temp files (as created by Vim)
2014-02-18 18:34:29 -05:00
* Configurable number of posts on [homepage ](/layout/homepage/ )
2015-01-27 21:17:09 -05:00
* [Front matter ](/content/front-matter/ ) supports multiple types (int, string, date, float)
2013-11-15 23:47:53 -05:00
* Indexes can now use a default template
* Addition of truncated bool to content to determine if should show 'more' link
2015-01-27 21:17:09 -05:00
* Support for [linkTitles ](/layout/variables/ )
2013-11-15 23:47:53 -05:00
* Better handling of most errors with directions on how to resolve
2013-11-05 00:24:04 -05:00
* Support for more date / time formats
* Support for go 1.2
2013-11-18 18:31:02 -05:00
* Support for `first` in templates
2014-01-10 21:19:19 -05:00
2015-12-19 06:32:06 -05:00
----
2014-01-10 21:19:19 -05:00
## **0.8.0** August 2, 2013
2014-09-01 10:00:45 -04:00
This release represents over 65 code commits from 6 different contributors.
2013-08-03 03:30:34 -04:00
* Added support for pretty urls (filename/index.html vs filename.html)
* Hugo supports a destination directory
* Will efficiently sync content in static to destination directory
* Cleaned up options.. now with support for short and long options
* Added support for TOML
* Added support for YAML
* Added support for Previous & Next
* Added support for indexes for the indexes
* Better Windows compatibility
* Support for series
* Adding verbose output
* Loads of bugfixes
2014-01-10 21:19:19 -05:00
2015-12-19 06:32:06 -05:00
----
2014-01-10 21:19:19 -05:00
## **0.7.0** July 4, 2013
2013-07-04 11:32:55 -04:00
* Hugo now includes a simple server
* First public release
2014-01-10 21:19:19 -05:00
2015-12-19 06:32:06 -05:00
----
2014-01-10 21:19:19 -05:00
## **0.6.0** July 2, 2013
2013-07-04 11:32:55 -04:00
* Hugo includes an example documentation site which it builds
2014-01-10 21:19:19 -05:00
2015-12-19 06:32:06 -05:00
----
2014-01-10 21:19:19 -05:00
## **0.5.0** June 25, 2013
2013-07-04 11:32:55 -04:00
* Hugo is quite usable and able to build spf13.com