diff --git a/content/about/benefits.md b/content/about/benefits.md index 3ead23ce2..fc50657b4 100644 --- a/content/about/benefits.md +++ b/content/about/benefits.md @@ -1,7 +1,7 @@ --- title: The Benefits of Static Site Generators linktitle: The Benefits of Static -description: Learn the benefits of static site generators, including performance, security, ease of use, and exportability of content. +description: Improved performance, security, ease of use, and exportability of content and just a few of the reasons static site generators have become so popular. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/news/release-notes.md b/content/news/release-notes.md index 3d3e259c7..8dd360c40 100644 --- a/content/news/release-notes.md +++ b/content/news/release-notes.md @@ -1,7 +1,7 @@ --- title: Release Notes linktitle: Release Notes -description: Information on the Hugo license. +description: See the full list of Hugo release notes since v0.05 in June 2015. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 @@ -14,6 +14,81 @@ toc: true notesforauthors: --- +## **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, {{< gh "@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 ({{}}), 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 ({{}}). 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. {{}} +* Add `truncate` template function {{}} +* Add `now` function, which replaces the now deprecated `.Now` {{}} +* Make RSS item limit configurable {{}} + +### Enhancements + +* Enhance `.Param` to permit arbitrarily nested parameter references {{}} +* Use `Page.Params` more consistently when adding metadata {{}} +* The `sectionPagesMenu` feature ("Section menu for the lazy blogger") is now integrated with the section content pages. {{}} +* Hugo `0.19` is compiled with Go 1.8! +* Make template funcs like `findRE` and friends more liberal in what argument types they accept {{}} {{}} +* Improve generation of OpenGraph date tags {{}} + +### 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. {{}} + +### Fixes + +* Fix `.Site.LastChange` on sites where the default sort order is not chronological. {{}} +* Fix regression of `.Truncated` evaluation in manual summaries. {{}} +* Fix `preserveTaxonomyNames` regression {{}} +* Fix issue with taxonomies when only some have content page {{}} +* Fix instagram shortcode panic on invalid ID {{}} +* Fix subtle data race in `getJSON` {{}} +* Fix deadlock in cached partials {{}} +* Avoid double-encoding of paginator URLs {{}} +* Allow tilde in URLs {{}} +* Fix `.Site.Pages` handling on live reloads {{}} +* `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. {{}} +* Fix infinite loop in template AST handling for recursive templates {{}} +* Fix issue with watching when config loading fails {{}} +* Correctly flush the imageConfig on live-reload {{}} +* Fix parsing of TOML arrays in frontmatter {{}} + +### Docs + +* Add tutorial "How to use Google Firebase to host a Hugo site" {{}} +* Improve documentation for menu rendering {{}} +* Revise GitHub Pages deployment tutorial {{}} + ## **0.18.1** December 30th 2016 Hugo 0.18.1 is a bug fix release fixing some issues introduced in Hugo 0.18: @@ -45,10 +120,9 @@ and also a big thanks to {{< gh "@moorereason" >}} and {{< gh "@bogem" >}} for t We wish you all a Merry Christmas and a Happy New Year.
*The Hugo team* -## Highlights +### Highlights -The primary new feature in Hugo 0.18 is that every piece of content is now a `Page` ({{}}). -This means that every page, including the home page, can have a content file with front matter. +The primary new feature in Hugo 0.18 is that every piece of content is now a `Page` ({{}}). This means that every page, including the homepage, can have a content file with front matter. Not only is this a much simpler model to understand, it is also faster and paved the way for several important new features: @@ -60,7 +134,7 @@ Not only is this a much simpler model to understand, it is also faster and paved Hugo again continues its trend of each release being faster than the last. It's quite a challenge to consistently add significant new functionality and simultaneously dramatically improve performance. Running [this benchmark]( https://github.com/bep/hugo-benchmark) with [these sites](https://github.com/bep/hugo-benchmark/tree/master/sites) (renders to memory) shows about 60% reduction in time spent and 30% reduction in memory usage compared to Hugo 0.17. -## Other New Features +### Other New Features * Every `Page` now has a `Kind` property. Since everything is a `Page` now, the `Kind` is used to differentiate different kinds of pages. Possible values are `page`, `home`, `section`, `taxonomy`, and `taxonomyTerm`. @@ -76,7 +150,7 @@ Hugo again continues its trend of each release being faster than the last. It's * Add `quiet` build mode {{}} -## Notices +### Notices * `.Site.Pages` will now contain *several kinds of pages*, including regular pages, sections, taxonomies, and the home page. If you want a specific kind of page, you can filter it with `where` and `Kind`. @@ -85,7 +159,7 @@ Hugo again continues its trend of each release being faster than the last. It's Note that in Hugo 0.17 both of them existed, so there is a fifty-fifty chance you will not have to do anything (if you use a theme, the chance is close to 0), and `RSSlink` will still work for two Hugo versions. -## Fixes +### Fixes * Revise the `base` template lookup logic so it now better matches the behavior of regular templates, making it easier to override the master templates from the theme {{}} * Add workaround for `block` template crash. @@ -102,7 +176,7 @@ Hugo again continues its trend of each release being faster than the last. It's * Only watch relevant themes dir {{}} * Hugo new content creates TOML slices with closing bracket on new line {{}} -## Improvements +### Improvements * Add page information to error logging in rendering {{}} * Deprecate `RSSlink` in favor of `RSSLink` @@ -114,7 +188,7 @@ Hugo again continues its trend of each release being faster than the last. It's * Avoid reading from Viper for path and URL funcs {{}} * Add `partialCached` template function. This can be a significant performance boost if you have complex partials that does not need to be rerendered for every page. {{}} -## Documentation Updates +### Documentation Updates * Update roadmap {{}} * Update multilingual example {{}} @@ -502,7 +576,8 @@ Hugo also depends on a lot of other great projects. A big thanks to all of our d [BurntSushi](https://github.com/BurntSushi/toml), [goYaml](https://github.com/go-yaml/yaml/tree/v2), and the Go standard library. -## New features +### New features + * Support for all file types in content directory. * If dedicated file type handler isn’t found it will be copied to the destination. * Add `AsciiDoc` support using external helpers. @@ -517,7 +592,8 @@ Hugo also depends on a lot of other great projects. A big thanks to all of our d * `seq`, a sequence generator very similar to its Gnu counterpart * `absURL` and `relURL`, both of which takes the `BaseURL` setting into account -## Improvements +### Improvements + * Highlighting with `Pygments` is now cached to disk -- expect a major speed boost if you use it! * More Pygments highlighting options, including `line numbers` * Show help information to Windows users who try to double click on `hugo.exe`. @@ -527,14 +603,16 @@ Hugo also depends on a lot of other great projects. A big thanks to all of our d * Allow the same `shortcode` to be used with or without inline content * Configurable RSS output filename -## Bugfixes +### Bugfixes + * Fix panic with paginator and zero pages in result set. * Fix crossrefs on Windows. * Fix `eq` and `ne` template functions when used with a raw number combined with the result of `add`, `sub` etc. * Fix paginator with uglyURLs * Fix {{< gh 998 >}}, supporting UTF8 characters in Permalinks. -## Notices +### 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 diff --git a/content/templates/base.md b/content/templates/base.md index 79e2755f1..034039530 100644 --- a/content/templates/base.md +++ b/content/templates/base.md @@ -1,7 +1,7 @@ --- title: Base Templates and Blocks linktitle: -description: The base and block constructs allow you to define the outer shell of your master templates (i.e., the chrome of the page) in a syntax that allows for easy extending and overwriting. +description: The base and block constructs allow you to define the outer shell of your master templates (i.e., the chrome of the page). godocref: https://golang.org/pkg/text/template/#example_Template_block date: 2017-02-01 publishdate: 2017-02-01 diff --git a/content/templates/content-view-templates.md b/content/templates/content-view-templates.md index 307c32474..5d42e6d79 100644 --- a/content/templates/content-view-templates.md +++ b/content/templates/content-view-templates.md @@ -1,7 +1,7 @@ --- title: Content View Templates -linktitle: -description: +linktitle: Content Views +description: Hugo can render alternative views of your content, which is especially useful in list and summary views. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/custom-404-page.md b/content/templates/custom-404-page.md index 19dbdbb8e..96398a14a 100644 --- a/content/templates/custom-404-page.md +++ b/content/templates/custom-404-page.md @@ -1,7 +1,7 @@ --- title: Custom 404 Page linktitle: 404 Page -description: +description: If you know how to create a single page template, you have unlimited options for creating a custom 404. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/data-templates.md b/content/templates/data-templates.md index e17443529..6b60c07a7 100644 --- a/content/templates/data-templates.md +++ b/content/templates/data-templates.md @@ -1,7 +1,7 @@ --- title: Data Templates linktitle: -description: +description: In addition to the Hugo's many built-in variables, you can specify your own custom data in templates or shortcodes that pull from both local and dynamic sources. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/menu-templates.md b/content/templates/menu-templates.md index 9357ab586..a433c13d8 100644 --- a/content/templates/menu-templates.md +++ b/content/templates/menu-templates.md @@ -1,7 +1,7 @@ --- title: Menu Templates linktitle: Menu Templates -description: +description: Menus are a powerful but simple feature for content management but can be easily manipulated in your templates to meet your design needs. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/pagination.md b/content/templates/pagination.md index f2dc5cb8c..22c02128c 100644 --- a/content/templates/pagination.md +++ b/content/templates/pagination.md @@ -1,7 +1,7 @@ --- title: Pagination linktitle: Pagination -description: +description: Hugo supports pagination for your homepage, section pages, and taxonomies and shines when combined with Hugo's SQL-like operators. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/partials.md b/content/templates/partials.md index 82909b117..b948203a0 100644 --- a/content/templates/partials.md +++ b/content/templates/partials.md @@ -1,7 +1,7 @@ --- title: Partial Templates linktitle: Partial Templates -description: +description: Partials are smaller, context-aware components in your list and page templates that can be used economically to keep your templating DRY. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/robots.md b/content/templates/robots.md index 5194d1095..3346b72bf 100644 --- a/content/templates/robots.md +++ b/content/templates/robots.md @@ -1,7 +1,7 @@ --- title: Robots.txt File linktitle: Robots.txt -description: +description: Hugo can generate a customized robots.txt in the same way as any other template. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/rss-templates.md b/content/templates/rss-templates.md index 9a43911ae..fdc826dc3 100644 --- a/content/templates/rss-templates.md +++ b/content/templates/rss-templates.md @@ -1,7 +1,7 @@ --- title: RSS Templates linktitle: RSS Templates -description: +description: Hugo ships with its own RSS 2.0 template that requires almost no configuration, or you can create your own RSS templates. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/section-templates.md b/content/templates/section-templates.md index afb84d7c5..1d36ee0cf 100644 --- a/content/templates/section-templates.md +++ b/content/templates/section-templates.md @@ -1,7 +1,7 @@ --- title: Section Page Templates linktitle: Section Page Templates -description: +description: Templates used for section pages are lists and therefore have all the variables and methods available to list pages. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/shortcode-templates.md b/content/templates/shortcode-templates.md index b92cdcd16..c6a9c9b6d 100644 --- a/content/templates/shortcode-templates.md +++ b/content/templates/shortcode-templates.md @@ -1,7 +1,7 @@ --- title: Shortcode Templates linktitle: Shortcode Templates -description: +description: You can extend Hugo's built-in shortcodes by creating your own using the same templating syntax as that for single and list pages. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/single-page-templates.md b/content/templates/single-page-templates.md index 11e06ee98..d26c45e2a 100644 --- a/content/templates/single-page-templates.md +++ b/content/templates/single-page-templates.md @@ -1,7 +1,7 @@ --- title: Single Page Templates linktitle: -description: +description: The primary view of content in Hugo is the single view. Hugo will render every Markdown file provided with a corresponding single template. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/sitemap-template.md b/content/templates/sitemap-template.md index 7f759162c..a3722e6f6 100644 --- a/content/templates/sitemap-template.md +++ b/content/templates/sitemap-template.md @@ -1,7 +1,7 @@ --- title: Sitemap Template linktitle: Sitemap -description: +description: Hugo ships with a built-in template file observing the v0.9 of the Sitemap Protocol, but you can override this template if needed. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/templates/taxonomy-templates.md b/content/templates/taxonomy-templates.md index ef597b6f2..e693331cc 100644 --- a/content/templates/taxonomy-templates.md +++ b/content/templates/taxonomy-templates.md @@ -1,7 +1,7 @@ --- title: Taxonomy Templates linktitle: -description: +description: Taxonomy templating includes taxonomy list pages, taxonomy terms pages, and the ability to iterate through taxonomies in your single page templates as well. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/variables/_index.md b/content/variables/_index.md index 646b7d8b6..ff29af9c7 100644 --- a/content/variables/_index.md +++ b/content/variables/_index.md @@ -13,6 +13,6 @@ aliases: [/templates/variables/] toc: false --- -[Go templates][], the backbone of Hugo templating, are context based, and Hugo makes a large number of values available to you as you're creating views for your website. The following variables and params provide convenient means to displaying your content with Hugo's powerful templating engine. +Hugo's templates are context aware and make a large number of values available to you as you're creating views for your website. [Go templates]: /templates/go-templates/ "Understand context in Go templates by learning the language's fundamental templating functions." \ No newline at end of file diff --git a/content/variables/file-variables.md b/content/variables/file-variables.md index 02973c6b7..13cee4baf 100644 --- a/content/variables/file-variables.md +++ b/content/variables/file-variables.md @@ -1,7 +1,7 @@ --- title: File Variables linktitle: -description: +description: Hugo provides the ability to traverse your website's files on your server, including the local Hugo server. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/content/variables/other.md b/content/variables/other.md index 68bf97bc9..587c534b8 100644 --- a/content/variables/other.md +++ b/content/variables/other.md @@ -1,7 +1,7 @@ --- title: Shortcode, Git, Menu, and Hugo Variables linktitle: Shortcode, Git, and Hugo Variables -description: +description: Many of Hugo's additional features come with their own pre-packaged variables to keep your templating lightweight. date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 diff --git a/data/homepagefeatures.toml b/data/homepagefeatures.toml index 071035f2a..2434ede9c 100644 --- a/data/homepagefeatures.toml +++ b/data/homepagefeatures.toml @@ -10,7 +10,7 @@ [[feature]] name = "Robust Content Management" - description = "You need more than front matter to make static scalable. Hugo offers support for taxonomies, unlimited content types, DRY templating, URL management, menus, archetypes, summaries, and so much more without the need for plugins." + description = "You need more than front matter to make static scalable. Hugo offers support for taxonomies, unlimited content types, DRY templating, URL management, menus, archetypes, summaries, and so much more, all without the need for plugins." order = 3 [[feature]]