shithub: hugo

Download patch

ref: e3daa359ecbe77e8ad7a6ec5e76e634c6530e599
parent: 22d85c2a182642da010e3963d5ed5c64325aebb7
author: spf13 <[email protected]>
date: Tue Feb 10 05:58:20 EST 2015

Update release notes for v0.13

--- a/docs/content/meta/release-notes.md
+++ b/docs/content/meta/release-notes.md
@@ -10,54 +10,96 @@
 weight: 10
 ---
 
-## **0.13.0** ???, 2015
+## **0.13.0** Feb 14, 2015
 
-A lot has happened since Hugo v0.12.0 was released. 
+Hugo has seen a lot of improvements since v0.12.0 was released. 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, 23 themes and 1000s of happy users.
 
-* Changes to docs:
-	* A new [Troubleshooting](/troubleshooting/overview/) section is added
-	* It's now searchable through Google Custom Search ([#753][])
-	* Some new great tutorials:
-		* [Automated deployments with Wercker](/tutorials/automated-deployments/)
-		* [Creating a new theme](/tutorials/creating-a-new-theme/)
+This release represents 392 contributions by 56 contributors
+
+A special shout out to [@bep](https://github.com/bep) and
+[@anthonyfok](https://github.com/anthonyfok) for their new role as Hugo
+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)
+  located in the `data` directory ([#885][])
+* Support for dynamically loading JSON & CSV from remote sources via GetJson
+  and GetJson in short codes or other layout files ([#748][])
+* [Pagination support](/extras/pagination/) for home page, sections and
+  taxonomies ([#750][])
+* 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
+* [Ace](http://ace.yoss.si/) template engine support ([#541][])
+* 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
+  better error messages. 
 * Several improvements to the [template functions](/templates/functions/):
-	* `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"`)
+    * `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"`)
 * New template functions:
-	* `apply`
-	* `chomp`
-	* `delimit`
-	* `sort`
-	* `markdownify`
-	* `in` and `intersect` 
-	* `trim`
-	* `replace`
-	* `dateFormat`
-* A top level `Hugo` variable 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)`
-* The [shortcode](/extras/shortcodes/) handling is rewritten for speed and better error messages. Noticeable functional change is the distinction between `{{</* */>}}` (typically raw HTML) and `{{%/* */%}}` (Markdown)
+    * `apply`
+    * `chomp`
+    * `delimit`
+    * `sort`
+    * `markdownify`
+    * `in` and `intersect` 
+    * `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
+* URLs in XML output is now correctly canonified ([#725][], [#728][], and part
+  of [#789][])
+
+### 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
+    * It's now searchable through Google Custom Search ([#753][])
+    * Some new great tutorials:
+        * [Automated deployments with
+          Wercker](/tutorials/automated-deployments/)
+        * [Creating a new theme](/tutorials/creating-a-new-theme/)
 * Support for [cross-references](/extras/crossreferences/)
-* `Scratch` -- [a "scratchpad"](/extras/scratch) for your node- and page-scoped variables
-* 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
-* 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
-* The content is now copied from archetype on `hugo new` (in addition to the front matter metadata)
+* The content is now copied from archetype on `hugo new` (in addition to the
+  front matter metadata)
 * Improved unit test coverage
-* 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
-* [Ace](http://ace.yoss.si/) template engine support ([#541][])
-* Add [pagination support](/extras/pagination/) for home page, sections and taxonomies ([#750][])
 * Fixed a lot of Windows-related path issues
 * Improved error messages for template and rendering errors
 * Enabled soft LiveReload of CSS and images ([#490][])
 * Various fixes in RSS feed generation ([#789][])
-* URLs in XML output is now correctly canonified ([#725][], [#728][], and part of [#789][])
 * `HasMenuCurrent` and `IsMenuCurrent` is now supported on Nodes
 * A bunch of [bug fixes](https://github.com/spf13/hugo/commits/master)
 
@@ -65,9 +107,11 @@
 [#541]: https://github.com/spf13/hugo/pull/541 "Pull Request #541: Add Ace template engine support"
 [#725]: https://github.com/spf13/hugo/issues/725 "Issue #725: CanonifyUrls does not canonicalize urls in RSS"
 [#728]: https://github.com/spf13/hugo/issues/728 "Pull Request #728: Add ability to canonify URLs in rendered XML output."
+[#748]: https://github.com/spf13/hugo/issues/748 "Feature: GetJson and GetJson in short codes or other layout files"
 [#750]: https://github.com/spf13/hugo/issues/750 "Pull Request: Add pagination support for home page, sections and taxonomies"
 [#753]: https://github.com/spf13/hugo/issues/753 "Add search to documentation"
 [#789]: https://github.com/spf13/hugo/issues/789 "Issue #789: RSS feeds do not validate"
+[#885]: https://github.com/spf13/hugo/issues/885 "Feature/datadir"
 
 
 ## **0.12.0** Sept 1, 2014