docs: Add release notes for Hugo 0.19

This commit is contained in:
Bjørn Erik Pedersen 2017-02-27 10:35:31 +01:00 committed by GitHub
parent eb572c8a18
commit c9c889c198

View file

@ -9,7 +9,78 @@ menu:
title: Release Notes title: Release Notes
weight: 10 weight: 10
--- ---
## **0.18.1** December 30th 2016
# **0.19** February 27th 2017
We're happy to announce the first release of Hugo in 2017.
This release represents **over 180 contributions by over 50 contributors** to the main Hugo code base. Since last release Hugo has **gained 1450 stars, 35 new contributors and 15 additional themes.**
Hugo now has:
- 15200+ stars
- 470+ contributors
- 151+ themes
Furthermore, Hugo has its own Twitter account ([@gohugoio](https://twitter.com/gohugoio)) where we share bite-sized news and themes from the Hugo community.
{{< gh "@bep" >}} leads the Hugo development and once again contributed a significant amount of additions. Also a big shoutout to {{< gh "chaseadamsio" >}} for the Emacs Org-mode support, {{< gh "@digitalcraftsman" >}} for his relentless work on keeping the documentation and the themes site in pristine condition, {{< "@fj" >}} for his work on revising the `params` handling in Hugo, and {{< gh "@moorereason" >}} and {{< gh "@bogem" >}} for their ongoing contributions.
## Highlights
Hugo `0.19` brings native Emacs Org-mode content support ({{<gh 1483>}}), big thanks to {{< gh "chaseadamsio" >}}.
Also, a considerably amount of work have been put into cleaning up the Hugo source code, in an issue titled [Refactor the globals out of site build](https://github.com/spf13/hugo/issues/2701). This is not immediately visible to the Hugo end user, but will speed up future development.
Hugo `0.18` was bringing full-parallel page rendering, so workarounds depending on rendering order did not work anymore, and pages with duplicate target paths (common examples would be `/index.md` or `/about/index.md`) would now conflict with the home page or the section listing.
With Hugo `0.19`, you can control this behaviour by turning off page types you do not want ({{<gh 2534 >}}). In its most extreme case, if you put the below setting in your `config.toml`, you will get **nothing!**:
```
disableKinds = ["page", "home", "section", "taxonomy", "taxonomyTerm", "RSS", "sitemap", "robotsTXT", "404"]
```
## Other New Features
* Add ability to sort pages by frontmatter parameters, enabling easy custom "top 10" page lists. {{<gh 3022 >}}
* Add `truncate` template function {{<gh 2882 >}}
* Add `now` function, which replaces the now deprecated `.Now` {{<gh 2882 >}}
* Make RSS item limit configurable {{<gh 3035 >}}
## Enhancements
* Enhance `.Param` to permit arbitrarily nested parameter references {{<gh 2598 >}}
* Use `Page.Params` more consistently when adding metadata {{<gh 3033 >}}
* The `sectionPagesMenu` feature ("Section menu for the lazy blogger") is now integrated with the section content pages. {{<gh 2974 >}}
* Hugo `0.19` is compiled with Go 1.8!
* Make template funcs like `findRE` and friends more liberal in what argument types they accept {{<gh 3018 >}} {{<gh 2822 >}}
* Improve generation of OpenGraph date tags {{<gh 2979 >}}
## Notes
* `sourceRelativeLinks` is now deprecated and will be removed in Hugo `0.21` if no one is stepping up to the plate and fixes and maintains this feature. {{<gh 3028 >}}
## Fixes
* Fix `.Site.LastChange` on sites where the default sort order is not chronological. {{<gh 2909 >}}
* Fix regression of `.Truncated` evaluation in manual summaries. {{<gh 2989 >}}
* Fix `preserveTaxonomyNames` regression {{<gh 3070 >}}
* Fix issue with taxonomies when only some have content page {{<gh 2992 >}}
* Fix instagram shortcode panic on invalid ID {{<gh 3048 >}}
* Fix subtle data race in `getJSON` {{<gh 3045 >}}
* Fix deadlock in cached partials {{<gh 2935 >}}
* Avoid double-encoding of paginator URLs {{<gh 2177 >}}
* Allow tilde in URLs {{<gh 2177 >}}
* Fix `.Site.Pages` handling on live reloads {{<gh 2869 >}}
* `UniqueID` now correctly uses the fill file path from the content root to calculate the hash, and is finally ... unique!
* Discard current language based on `.Lang()`, go get translations correct for paginated pages. {{<gh 2972 >}}
* Fix infinite loop in template AST handling for recursive templates {{<gh 2927 >}}
* Fix issue with watching when config loading fails {{<gh 2603 >}}
* Correctly flush the imageConfig on live-reload {{<gh 3016 >}}
* Fix parsing of TOML arrays in frontmatter {{<gh 2752 >}}
## Docs
* Add tutorial "How to use Google Firebase to host a Hugo site" {{<gh 3007 >}}
* Improve documentation for menu rendering {{<gh 3056 >}}
* Revise GitHub Pages deployment tutorial {{<gh 2930 >}}
# **0.18.1** December 30th 2016
Hugo 0.18.1 is a bug fix release fixing some issues introduced in Hugo 0.18: Hugo 0.18.1 is a bug fix release fixing some issues introduced in Hugo 0.18:
@ -19,7 +90,7 @@ Hugo 0.18.1 is a bug fix release fixing some issues introduced in Hugo 0.18:
* Fix `IsTranslated` and `Translations` for node pages {{<gh 2812 >}} * Fix `IsTranslated` and `Translations` for node pages {{<gh 2812 >}}
* Make template error messages more verbose {{<gh 2820 >}} * Make template error messages more verbose {{<gh 2820 >}}
## **0.18.0** December 19th 2016 # **0.18.0** December 19th 2016
Today, we're excited to release the much-anticipated Hugo 0.18! Today, we're excited to release the much-anticipated Hugo 0.18!
@ -69,7 +140,6 @@ Hugo again continues its trend of each release being faster than the last. It's
* Add `noChmod` option to disable perm sync {{<gh 2749>}} * Add `noChmod` option to disable perm sync {{<gh 2749>}}
* Add `quiet` build mode {{<gh 1218>}} * Add `quiet` build mode {{<gh 1218>}}
## Notices ## Notices
* `.Site.Pages` will now contain *several kinds of pages*, including regular pages, sections, taxonomies, and the home page. * `.Site.Pages` will now contain *several kinds of pages*, including regular pages, sections, taxonomies, and the home page.
@ -96,6 +166,7 @@ Hugo again continues its trend of each release being faster than the last. It's
* Only watch relevant themes dir {{<gh 2602>}} * Only watch relevant themes dir {{<gh 2602>}}
* Hugo new content creates TOML slices with closing bracket on new line {{<gh 2800>}} * Hugo new content creates TOML slices with closing bracket on new line {{<gh 2800>}}
## Improvements ## Improvements
* Add page information to error logging in rendering {{<gh 2570>}} * Add page information to error logging in rendering {{<gh 2570>}}
@ -300,14 +371,11 @@ times decreased anywhere from 10% to 99%.
`PygmentsCodeFencesGuessSyntax = true` {{<gh 2034>}} `PygmentsCodeFencesGuessSyntax = true` {{<gh 2034>}}
* Make `ByCount` sort consistently {{<gh 1930>}} * Make `ByCount` sort consistently {{<gh 1930>}}
* Add `Scratch` to shortcode {{<gh 2000>}} * Add `Scratch` to shortcode {{<gh 2000>}}
* Add support for symbolic links for content, layout, static, theme {{<gh 1855 * 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 * Add '+' as one of the valid characters in URLs specified in the front matter
{{<gh 1290 >}} {{<gh 1290 >}}
* Make alias redirect output URLs relative when `RelativeURLs = true` {{<gh * Make alias redirect output URLs relative when `RelativeURLs = true` {{<gh 2093 >}}
2093 >}} * Hugo injects meta generator tag on homepage if missing {{<gh 2182 >}}
* Hugo injects meta generator tag on homepage if missing {{<gh
2182 >}}
### Fixes ### Fixes
* Fix file change watcher for TextMate 2 and friends on OS X {{<gh 1053 >}} * Fix file change watcher for TextMate 2 and friends on OS X {{<gh 1053 >}}