shithub: hugo

--- a/docs/content/meta/release-notes.md

+++ b/docs/content/meta/release-notes.md

@@ -15,14 +15,14 @@

 A lot has happened since Hugo v0.12.0 was released.

 * Changes to docs:

-	* New Troubleshooting section is added

-	* It's now searchable through Google Custom Search

+	* A new [Troubleshooting](/troubleshooting/overview) section is added

+	* It's now searchable through Google Custom Search ([#753][])

 	* Some new great tutorials:

-		* [Automated deployments](/tutorials/automated-deployments)

+		* [Automated deployments with Wercker](/tutorials/automated-deployments)

 		* [Creating a new theme](/tutorials/creating-a-new-theme)

 * 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 (i.e. `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`

@@ -41,21 +41,28 @@

 * Support for [cross-references](/extras/crossreferences)

 * 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 improvements related to Markdown rendering:

+* Several [configurable improvements related to Markdown rendering](/overview/configuration/#configure-blackfriday-rendering:a66b35d20295cb764719ac8bd35837ec):

 	* Configuration of footnote rendering

-	* Optional support for angled quotes

+	* 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)

 * 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 templates support

+* [Ace](http://ace.yoss.si/) template engine support ([#541][])

 * Fixed a lot of Windows-related path issues

 * Improved error messages for template and rendering errors

-* Various fixes in RSS feed generation

-* Enabled soft livereload of CSS and images

-* URLs in XML output is now correctly canonified

+* 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)

+[#490]: https://github.com/spf13/hugo/pull/490 "Pull Request #490: Livereload CSS and images without browser refresh"

+[#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."

+[#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"

 ## **0.12.0** Sept 1, 2014

--- a/docs/content/overview/configuration.md

+++ b/docs/content/overview/configuration.md

@@ -88,7 +88,7 @@

 </tr>

 <tr>

 <td class="purpose-title">Purpose:</td>

-<td class="purpose-description" colspan="2">Enable angled double quotes (<code>« »</code>)</td>

+<td class="purpose-description" colspan="2">Enable smart angled double quotes <small>(e.g.&nbsp;<code>"Hugo"</code> renders to «Hugo» instead of “Hugo”)</small></td>

 </tr>

 <tr>

@@ -98,19 +98,29 @@

 </tr>

 <tr>

 <td class="purpose-title">Purpose:</td>

-<td class="purpose-description" colspan="2">If <code>true</code>, then header and footnote IDs are generated without the document ID <small>(so,&nbsp;<code>#my-header</code> instead of <code>#my-header:bec3ed8ba720b9073ab75abcf3ba5d97</code>)</small></td>

+<td class="purpose-description" colspan="2">If <code>true</code>, then header and footnote IDs are generated without the document ID <small>(e.g.&nbsp;<code>#my-header</code> instead of <code>#my-header:bec3ed8ba720b9073ab75abcf3ba5d97</code>)</small></td>

 </tr>

 </tbody>

 </table>

-**Note** that these flags must be grouped under the `blackfriday` key and can be set on **both site and page level**. If set on page, it will override the site setting.

+**Note** that these flags must be grouped under the `blackfriday` key and can be set on **both site and page level**. If set on page, it will override the site setting.  Example:

-```

-blackfriday:

-  angledQuotes = true

-  plainIdAnchors = true

-```

+<table class="table">

+<tr>

+<th>TOML</th><th>YAML</th>

+</tr>

+<tr>

+<td><pre><code>[blackfriday]

+    angledQuotes = true

+    plainIdAnchors = true

+</code></pre></td>

+<td><pre><code>blackfriday:

+  angledQuotes: true

+  plainIdAnchors: true

+</code></pre></td>

+</tr>

+</table>

 ## Notes

--- a/docs/content/templates/functions.md

+++ b/docs/content/templates/functions.md

@@ -76,7 +76,7 @@

+++

     {{ range where .Site.Recent "Params.series" "golang" }}

-       {{ .Content}}

+       {{ .Content }}

     {{ end }}

 It can also be used with an operator like `!=`, `>=`, `in` etc. Without an operator (like above), `where` compares a given field with a matching value in a way like `=` is specified.

@@ -84,7 +84,7 @@

 e.g.

     {{ range where .Data.Pages "Section" "!=" "post" }}

-       {{ .Content}}

+       {{ .Content }}

     {{ end }}

 Following operators are now available

@@ -111,6 +111,7 @@

 Works on [lists](/templates/list/), [taxonomies](/taxonomies/displaying/), [terms](/templates/terms/), [groups](/templates/list/)

 e.g.

     // Front matter

+++

     tags: [ "tag1", "tag2", "tag3" ]

@@ -132,6 +133,7 @@

 Works on [lists](/templates/list/), [taxonomies](/taxonomies/displaying/), [terms](/templates/terms/), [groups](/templates/list/)

 e.g.

     // Front matter

+++

     tags: [ "tag3", "tag1", "tag2" ]