Polish 0.15 release notes

Add first draft of Hugo 0.15 Release Notes

Use LazyFileReader for reading file contents

Simple ioutil.ReadFile is used for reading file contents but it reads
all of the file contents and copies them into the memory and is run in a
single goroutine. It causes much memory consumption at copying media
files in content directory to publish directory and it is not good at
performance.

This improves the both issue by replacing ReadFile with LazyFileReader.

It postpones reading the file contents until it is really needed. As the
result, actual file read is run in parallelized goroutine. It improves
performance especially in a really big site.

In addition, if this reader is called from io.Copy, it does not copy the
file contents into the memory but just copies them into destination
file. It improves much memory consumption issue when the site has many
media files.

Fix #1181

Add LazyFileReader type to source library

LazyFileReader is an io.Reader implementation to postpone reading the
file contents until it is really needed. It is introduced for improving
performance and memory consumption at reading media files in content
directory.

Update Travis for Go 1.5

Fix -ldflags for Go 1.5

Use correct form -X <name>=<value> for Go 1.5

Fix typo, "delemiters" -> "delimiters"

Update press.md

New article about Hugo on the Snipcart blog.

Search current directory for config file by default

As of 2015-08-16, Viper no longer searches the CWD
for config file by default to avoid unintended surprises,
but Hugo relies on the original behaviour.

Fixed by calling

    viper.AddConfigPath(".")

at the appropriate place.

See https://github.com/spf13/viper/issues/73 for more information.

Fixes #1363

Use cast.ToIntE for int conversions in substr and slicestr

It is less restrictive, and it is what is used in other template funcs.

Slicestr fix for other int type param

Fixes #1347

Documentation update on Template Where Function for nil

Implement `hugo --theme=[Tab][Tab]` bash completion

using the new BashCompSubdirsInDir annotation in spf13/cobra.

Print feedback for `hugo genautocomplete`

Print feedback for `hugo gendoc`

Use spf13/pflag's new SetAnnotation helper

And make our bash completion code more compact.

Added sitemap configuration documentation.

Added mention of .Data.Pages, removed duplicate .Site.Pages mention.

docs: Remove minodisk's dsk.mn/ from Showcase

The domain dsk.mn expired in January 2015,
and unfortunately I was unable to reach the author
nor find his replacement website.

docs: Clean up and align Showcase thumbnail images

Some of the thumbnails in Showcase were out of place
because of several irregularly sized thumbnails,
and some of them almost 300KB in filesize.

Resize them all to 600x400 (pixels), and use the `-tn.png`
suffix.

When necessary, the website snapshot is re-captured using
gnome-web-photo.  Then, the following commands (or a combination
thereof) are used to crop and resize the image into a thumbnail,
and to reduce its filesize:

    $ convert example.png -crop 900x600+0+0 \
                          -filter Lanczos2Sharp -distort Resize 600x400 \
                          example-tn.png
    $ pngquant --nofs -v --speed 1 --quality 65-80 example-tn.png
    $ optipng -o7 -zm1-9 example-tn-or8.png
    $ mv example-tn-or8.png example-tn.png

docs: Add site title; set pluralizeListTitles = false

To prevent "Showcase" from becoming "Showcases",
also to have the RSS feed display correct titles,
i.e. "Showcase on gohugo.io" rather than "Showcase on ".

Add Arqueart to Showcase

Create arqueart.md

docs: More detailed explanation of .Site.LastChange

Removed extra .Site.LastChange listing

Doc for other supported formats (external helpers)

As Hugo now supports more formats thanks to the new "external helpers"
feature recently introduced, and as requested by some people, I added
some lines in the doc:
* basically confirming it actually exists
* how to use it

Reset Scratch for 404

The 404 pages etc. need a better solution, but fix this issue for now.

Fixes #1336

Revert "Fix some Go code doc issues"

This reverts commit de7dd70bbc1ac533f137e5f788e1b337d6ba6b8c.

Broke the code fence feat.

Avoid panic in shortcode param handling

Fixes #1337

Do not panic on index out of range in shortcode.Get

Fixes #1335

Also rename readDir in docs shortcode

Rename ReadDir to readDir

To make it consistent with the other template funcs.

Make sort tpl func accept field/key chaining arg

'sort' template function used to accept only each element's struct field
name, method name and map key name as its second argument. This extends
it to accept a field/method/key chaining key string like
'Params.foo.bar' as the argument. It evaluates sub elements of each
array or map elements and sorts by them.

Typical use case would be sorting pages by user defined front matter
value. For example, sorting pages by 'Params.foo.bar' is possible by
writing the following template code

    {{ range sort .Data.Pages "Params.foo.bar" }}
        {{ .Content }}
    {{ end }}

It ignores all leading and trailing dots so "Params.foo.bar" can be
written in ".Params.foo.bar"

This also fixes the issue that 'sort' cannot evaluate a pointer value.

Fix #1330

Fix sort tpl func to return explicit type value

sort template function returns `[]interface{}` type slice value
regardless of its original element type.

This fixes it to keep the original element type. For example, if it
sorts `map[string]int` type value, it returns `[]int` slice value
instead of `[]interface{}` slice value.

Fix Unicode issue in Slicestr and Substr

Fixes #1333

Fix some Go code doc issues

Add missing formatting directive in Printf call

To make Go Vet happy.

docs: Extend documentation on Blackfriday options

Especially to spell out how the `latexDashes` flag
changes the behavior of smart dashes

Add some float tests to TestArethmic

Add option to disable Blackfriday Smartypants

Can be used in site config or per page front matter:

```
[blackfriday]
smartypants = false
```

docs: Fix typos

docs: Bolden the blackfriday flags to make them stand out

And other minor HTML/CSS tweaks.

doc: Strip trailing whitespace; other revisions

Make some random and non-comprehensive changes to the
template functions documentation to make them more
consistent.

Strip trailing whitespace in code

Improve formatting of Hugo command descriptions

Trying to make them look good both in the terminal (`hugo help [command]`)
and in the web browser (http://gohugo.io/commands/).  :-)

Bump `hugo new theme` template min_version to 0.14

Fix searching YAML/TOML delimiters in frontmatter

When a YAML/TOML's delimiter character sequence is included in a
frontmatter string, parser mistakes it as a delimiter. This fixes it by
checking a character right before the delimiter sequence is '\n' or it
is the beginning of the frontmatter.

Fix #1320

Add map support to scratch

Trim trailing spaces from YAML and TOML delimiters

When someone hits space after typing "---" (or "+++") but before they
hit return, hugo silently failed to parse the file. This corrects that.

[Docs] Add <br> to an extra-long title in the Press page

docs: add netlify article to press section

Remove deprecated fields and methods for v0.15

Special thanks to @bep for his guidance and
for making sure all of the Hugo themes get updated.

Fixes #1172

Asciidoc[tor]: use --no-header-footer option

This simplifies the retrieval of the HTML (no more need to extract the
part within body) and also removes the unwanted "Last Updated" part in
the article.

Always use the template provided in page.Render

Fixes #1306

Fix inconsistent front matter handling

Fixes #768

Add ReadDir function to list local files.

Includes documentation.

Ignore non-presence of "layouts" directory in watch logic
Fixes #691

Fix periods in taxonomies create bad paths
Fixes #1188

Replace strings.Compare

Which is a Go 1.5 func.

See #1299

Fix sort test and title sort

See #1299

Fall back to link title for default page sort

Fixes #1299

The guide is updated to fit the current Wercker interface and configurations.
Wercker changed its interface and default infrastructure (Docker).

Remove point 7 in contributors guide

It makes sense on its own, but it contradicts 6). We need to revisit this one to make it more clear/better.

Make small fixes to README file
- Add a step to Contributor instructions for those modifying commands
- Change forum link to http (https does not work)
- Add "Sign the forum release thread" to contributor instructions

docs: fix prev in highlightling

Added szymonkatra.github.io site to showcase

Fix links to Ace and Amber pages

Add scottcwilson.github.io to showcase site

Move apply before cache put

It just looks better.

See #1293

docs: Rename dynamic content to data-driven content

Fixes #925

Fix data races in sorting and Reverse

The custom sort functions used from the templates had some subtle data race- and related issues,
especially when used in the single page template.

This commit fixes this by making copies and protect the read and writes with a RWMutex.

The results are cached (it will typically be invoked *number of pages* times with exactly the same data).

This is, not surprisingly, also faster:

```
benchmark                           old ns/op     new ns/op     delta
BenchmarkSortByWeightAndReverse     14228         491           -96.55%

benchmark                           old allocs     new allocs     delta
BenchmarkSortByWeightAndReverse     1              0              -100.00%

benchmark                           old bytes     new bytes     delta
BenchmarkSortByWeightAndReverse     32            0             -100.00%
```

Fixes #1293

Fix broken test

Add benchmark for sort and reverse

source/File: Fix data races

Document Amber templates
Fixes #1064

On error, return error message, not nil

Add a check for the setting of watch flag in config file

Fixes #1074

Let Amber template call Hugo's custom functions

Amber doesn't share text/template `FuncMap` functions and has its own
function list. This allows Amber to call Hugo's custom functions.

Fix name logic for Amber templates

Fix link to front matter

added leading backslash, changing [front matter](content/front-matter) to [front matter](/content/front-matter)

Fix unclear RSS template docs

The documentation for the RSS templating is a little unclear.
http://gohugo.io/templates/rss/

Some users may attempt to look for a ```__internal``` directory rather than assume that's the aforementioned "Hugo own template."

Here's my suggestion.

Add mention about .Hugo.Generator in 'Creating a theme' section

Fix typo: "taxononomy" -> "taxonomy"

Add paginator support for page groups

Fixed #1274

fix TestHomeNodeMenu test

Signed-off-by: Valere JEANTET <valere.jeantet@gmail.com>

Allow page.HasMenuCurrent() and node.HasMenuCurrent() to proceed with multi-level nested menus
Currently HasMenuCurrent only process the first 2 levels.

Log missing theme as FATAL

See #1234

Checks to ensure theme directory, if specified, exists

See #1234

Fix log message in test

Optimize RuneCount

Do not create it unless used.

See #1266

Add RuneCount to Page

Fixes #1266

Omit protocol from embedded font resources

Fixes the mixed content errors and loads fonts when accessing
https://gohugo.io/

Change arianv sourceLink to master branch

Add learnoverpass

Add arianv

add a showcase of sa.muel.be

[Docs] Press page. Fix URL

Add support for GitHub-flavoured markdown code fences for highlighting

This commit adds a new PygmentsCodeFences config option (default false), which if true will allow GitHub style backtick code fences around code, which will then be rendered by Pygments.

For example:

``` language
your code
```

can be used instead of {{< highlight language >}}your code {{< /highlight >}}.

Fixes #362

If no language is provided to Pygments, then try and guess it

Previously if no language was specified, then illegal args would be passed to pygments, for example `pygments -l -fhtml`, which would result in pygments printing an error.

Add a showcase of Kangkona