Merge branch 'master' of github.com:spf13/hugo

This commit is contained in:
bep 2015-01-19 02:41:16 +01:00
commit 109e6f95fd
4 changed files with 73 additions and 21 deletions

View file

@ -15,14 +15,14 @@ weight: 10
A lot has happened since Hugo v0.12.0 was released. A lot has happened since Hugo v0.12.0 was released.
* Changes to docs: * Changes to docs:
* New Troubleshooting section is added * A new [Troubleshooting](/troubleshooting/overview) section is added
* It's now searchable through Google Custom Search * It's now searchable through Google Custom Search ([#753][])
* Some new great tutorials: * 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) * [Creating a new theme](/tutorials/creating-a-new-theme)
* Several improvements to the [template functions](/templates/functions): * 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` 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` template function now also accepts dot chaining key argument (e.g. `"Params.foo.bar"`)
* New template functions: * New template functions:
* `apply` * `apply`
* `chomp` * `chomp`
@ -41,22 +41,29 @@ A lot has happened since Hugo v0.12.0 was released.
* Support for [cross-references](/extras/crossreferences) * Support for [cross-references](/extras/crossreferences)
* A new, generic Next/Prev functionality is added to all lists of pages (sections, taxonomies, etc) * 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 * 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 * Configuration of footnote rendering
* Optional support for angled quotes * Optional support for smart angled quotes, e.g. `"Hugo"` → «Hugo»
* Enable descriptive header IDs * 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 * 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 * 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 * Fixed a lot of Windows-related path issues
* Improved error messages for template and rendering errors * Improved error messages for template and rendering errors
* Various fixes in RSS feed generation * Enabled soft LiveReload of CSS and images ([#490][])
* Enabled soft livereload of CSS and images * Various fixes in RSS feed generation ([#789][])
* URLs in XML output is now correctly canonified * URLs in XML output is now correctly canonified ([#725][], [#728][], and part of [#789][])
* `HasMenuCurrent` and `IsMenuCurrent` is now supported on Nodes * `HasMenuCurrent` and `IsMenuCurrent` is now supported on Nodes
* A bunch of [bug fixes](https://github.com/spf13/hugo/commits/master) * 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 ## **0.12.0** Sept 1, 2014

View file

@ -88,7 +88,7 @@ But Hugo does expose some options---as listed in the table below, matched with t
</tr> </tr>
<tr> <tr>
<td class="purpose-title">Purpose:</td> <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>
<tr> <tr>
@ -98,19 +98,29 @@ But Hugo does expose some options---as listed in the table below, matched with t
</tr> </tr>
<tr> <tr>
<td class="purpose-title">Purpose:</td> <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> </tr>
</tbody> </tbody>
</table> </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:
``` <table class="table">
blackfriday: <tr>
angledQuotes = true <th>TOML</th><th>YAML</th>
plainIdAnchors = true </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 ## Notes

View file

@ -76,7 +76,7 @@ e.g.
+++ +++
{{ range where .Site.Recent "Params.series" "golang" }} {{ range where .Site.Recent "Params.series" "golang" }}
{{ .Content}} {{ .Content }}
{{ end }} {{ 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. 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 @@ It can also be used with an operator like `!=`, `>=`, `in` etc. Without an opera
e.g. e.g.
{{ range where .Data.Pages "Section" "!=" "post" }} {{ range where .Data.Pages "Section" "!=" "post" }}
{{ .Content}} {{ .Content }}
{{ end }} {{ end }}
Following operators are now available Following operators are now available
@ -111,6 +111,7 @@ Maps will be sorted by the keys, and only a slice of the values will be returned
Works on [lists](/templates/list/), [taxonomies](/taxonomies/displaying/), [terms](/templates/terms/), [groups](/templates/list/) Works on [lists](/templates/list/), [taxonomies](/taxonomies/displaying/), [terms](/templates/terms/), [groups](/templates/list/)
e.g. e.g.
// Front matter // Front matter
+++ +++
tags: [ "tag1", "tag2", "tag3" ] tags: [ "tag1", "tag2", "tag3" ]
@ -132,6 +133,7 @@ Sorts maps, arrays and slices, returning a sorted slice. A sorted array of map v
Works on [lists](/templates/list/), [taxonomies](/taxonomies/displaying/), [terms](/templates/terms/), [groups](/templates/list/) Works on [lists](/templates/list/), [taxonomies](/taxonomies/displaying/), [terms](/templates/terms/), [groups](/templates/list/)
e.g. e.g.
// Front matter // Front matter
+++ +++
tags: [ "tag3", "tag1", "tag2" ] tags: [ "tag3", "tag1", "tag2" ]

View file

@ -0,0 +1,33 @@
---
date: 2015-01-18T02:41:52-07:00
menu:
main:
parent: troubleshooting
title: Troubleshooting Overview
weight: 0
---
Got stuck? Worry not! Chances are other users have encountered
the exact same problem as you have, brought it up for
[discussion](http://discuss.gohugo.io/), and have likely found a solution
through the collective wisdom of our vibrant Hugo community!
Here are some examples:
* [`hugo new` aborts with cryptic EOF error](/troubleshooting/strange-eof-error/) (affects v0.12 and lower)
* [Categories with accented characters inaccessible](/troubleshooting/categories-with-accented-characters/) (affects Mac OS&nbsp;X users)
* [My CSS files aren't loaded!](http://discuss.gohugo.io/t/deployment-workflow/90/15)
* [How do I include an image gallery on my website?](http://discuss.gohugo.io/t/image-gallery/594)
* ... And a lot more!
Indeed, you may find many questions and solutions
to problems in our [discussion forum](http://discuss.gohugo.io/),
and you may find the [support](http://discuss.gohugo.io/category/support)
and [tips & tricks](http://discuss.gohugo.io/category/tips-tricks)
categories particularly helpful.
Can't find anything? Please write on the forum and post your questions
and comments! Sometimes, your feedback may lead to the discovery of
existing bugs in the code or in the documentation, and may even spur
the interest of adding new features to the next Hugo version, improving
Hugo for everybody! (Thank you!) See you on the forum!