diff --git a/content/news/release-notes.md b/content/news/release-notes.md index 8094c3ebc..28b280c5d 100644 --- a/content/news/release-notes.md +++ b/content/news/release-notes.md @@ -18,6 +18,126 @@ aliases: [/meta/release-notes/] toc: true --- +## **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](/templates/output-formats/) feature in `0.20`, and while the change was intentional and there was an ongoing discussion about fixing it in {{< gh 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`: + +```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): + +```toml +[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): + +```html + + + +``` + +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: + +```html +{{ with .OutputFormats.Get "css" }} + +{{ 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 {{< gh 3323 >}} +* camelCased templates (partials, shortcodes etc.) not found {{< gh 3333 >}} +* Live-reload fails with `_index.md` with paginator {{< gh 3315 >}} +* `rssURI` WARNING always shown {{< gh 3319 >}} + +See the [full list](https://github.com/spf13/hugo/milestone/16?closed=1). + +# **0.20** April 10th 2017 + +Hugo `0.20` introduces the powerful and long sought after feature [Custom Output Formats](/templates/output-formats/)); Hugo isn't just that "static HTML with an added RSS feed" anymore. *Say hello* to calendars, e-book formats, Google AMP, and JSON search indexes, to name a few ({{< gh 2828 >}}). + +This release represents **over 180 contributions by over 30 contributors** to the main Hugo code base. Since last release Hugo has **gained 1100 stars, 20 new contributors and 5 additional themes.** + +Hugo now has: + +* 16300+ stars +* 495+ contributors +* 156+ themes + +{{< gh "@bep" >}} still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. Also a big shoutout to {{< gh "@digitalcraftsman" >}} for his relentless work on keeping the documentation and the themes site in pristine condition, and {{< gh "@moorereason" >}} and {{< gh "@bogem" >}} for their ongoing contributions. + +## Other Highlights + +{{< gh "@bogem" >}} has also contributed TOML as an alternative and much simpler format for language/i18n files ({{< gh 3200 >}}). A feature you will appreciate when you start to work on larger translations. + +Also, there have been some important updates in the Emacs Org-mode handling: {{< gh "@chaseadamsio" >}} has fixed the newline-handling ({{< gh 3126 >}}) and {{< gh "@clockoon" >}} has added basic footnote support. + +Worth mentioning is also the ongoing work that {{< gh "@rdwatters" >}} and {{< gh "@budparr" >}} is doing to re-do the [gohugo.io](https://gohugo.io/) site, including a total restructuring and partial rewrite of the documentation. It is getting close to finished, and it looks fantastic! + +## Notes +* `RSS` description in the built-in template is changed from full `.Content` to `.Summary`. This is a somewhat breaking change, but is what most people expect from their RSS feeds. If you want full content, please provide your own RSS template. +* The deprecated `.RSSlink` is now removed. Use `.RSSLink`. +* `RSSUri` is deprecated and will be removed in a future Hugo version, replace it with an output format definition. +* The deprecated `.Site.GetParam` is now removed, use `.Site.Param`. +* Hugo does no longer append missing trailing slash to `baseURL` set as a command line parameter, making it consistent with how it behaves from site config. {{< gh 3262 >}} + +## Enhancements + +* Hugo `0.20` is built with Go 1.8.1. +* Add `.Site.Params.mainSections` that defaults to the section with the most pages. Plan is to get themes to use this instead of the hardcoded `blog` in `where` clauses. {{< gh 3206 >}} +* File extension is now configurable. {{< gh 320 >}} +* Impove `markdownify` template function performance. {{< gh 3292 >}} +* Add taxonomy terms' pages to `.Data.Pages` {{< gh 2826 >}} +* Change `RSS` description from full `.Content` to `.Summary`. +* Ignore "." dirs in `hugo --cleanDestinationDir` {{< gh 3202 >}} +* Allow `jekyll import` to accept both `2006-01-02` and `2006-1-2` date format {{< gh 2738 >}} +* Raise the default `rssLimit` {{< gh 3145 >}} +* Unify section list vs single template lookup order {{< gh 3116 >}} +* Allow `apply` to be used with the built-in Go template funcs `print`, `printf` and `println`. {{< gh 3139 >}} + +## Fixes +* Fix deadlock in `getJSON` {{< gh 3211 >}} +* Make sure empty terms pages are created. {{< gh 2977 >}} +* Fix base template lookup order for sections {{< gh 2995 >}} +* `URL` fixes: + * Fix pagination URLs with `baseURL` with sub-root and `canonifyUrls=false` {{< gh 1252 >}} + * Fix pagination URL for resources with "." in name {{< gh 2110 >}} {{< gh 2374 >}} {{< gh 1885 >}} + * Handle taxonomy names with period {{< gh 3169 >}} + * Handle `uglyURLs` ambiguity in `Permalink` {{< gh 3102 >}} + * Fix `Permalink` for language-roots wrong when `uglyURLs` is `true` {{< gh 3179 >}} + * Fix misc case issues for `URLs` {{< gh 1641 >}} + * Fix for taxonomies URLs when `uglyUrls=true` {{< gh 1989 >}} + * Fix empty `RSSLink` for list pages with content page. {{< gh 3131 >}} +* Correctly identify regular pages on the form "my_index_page.md" {{< gh 3234 >}} +* `Exit -1` on `ERROR` in global logger {{< gh 3239 >}} +* Document hugo `help command` {{< gh 2349 >}} +* Fix internal `Hugo` version handling for bug fix releases. {{< gh 3025 >}} +* Only return `RSSLink` for pages that actually have a RSS feed. {{< gh 1302 >}} + + ## **0.19** February 27th 2017 We're happy to announce the first release of Hugo in 2017.