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

Add how-to for foreign language month names

FYI @nicolinuxfr, added the month name example.

Add Rick and eSolia's sites to the Hugo docs showcase

Added missing "Social" section to SiteInfo

I could be wrong here, but it looks to me like .Site.Social.facebook is used in tpl/template_embedded.go, but the variable is never set. I've added a line to initializeSiteInfo to map the info from config into this variable.

Document Page.RawContent in templates/variables/

Add Page.RawContent() to access raw Markdown as a string.

In particular, RawContent() excludes the metadata header.

This is necessary in the use case of embedding remarkjs.com slides, as it needs
the unprocessed Markdown content to generate the slides.

Add nil comparison to where tpl function

`where` template function's internal condition check function always
returns `false` when a target value doesn't exist or it's nil value but
this behavior makes it difficult to filter values which doesn't have a
particular parameter.

To solve it, this adds nil value comparison to the function.
`where Values ".Param.key" nil` like clause can be used for the case
above.

Only "=", "==", "eq", "!=", "<>", "ne" operators are allowed to be used
with `nil`. If an other operator is passed with `nil`, the condition
check function returns `false` like before.

Fix #1232

Fix watcher detecting changes as static when no theme

There have been some changes to the ´helpers.GetThemesDirPath()´ so it now returns an empty string when no theme.

This is correct, but it broke the watch service (at lest on OSX), as `strings.HasPrefix("", "somestring") evaluates to true somehow, and content changes are incorrectly branded as static.

There are other issues in there, but that will come later ...

See #1236

Add doc for new Blackfriday options

See #1220
See #1231

Add config option for Blackfriday HTML_HREF_TARGET_BLANK

Fixes #1220

Add option to disable Blackfriday LaTeX style dashes

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

```
[blackfriday]
latexDashes = false
```

Fixes #1231

404 is homeless

Fixes #1235

added thumbnail

Create mariosanchez.md

Submitting site for consideration in Hugo Showcase

add vamp.io site as showcase

Use helpers.GetThemeDir() to find base templates.

Now that we have the helpers.GetThemeDir() function, use it instead of
calling directly into viper.

Refactor theme path helper functions.

Reduce duplication (`x + FilePathSeparator + y` a few lines away from `filepath.Join(x, y)`) and add a `GetThemeDir()` function to get the current theme's directory.

Also add a comment complaining about the `GetThemesDirPath()` function, which doesn't seem to do what its name would suggest. This might be a candidate for deprecation?

Add support for baseof.ace templates in themes.

When we find a template that requires a base template, we should also look
for that base template in the current theme.

Fixes #1215.

Proper parsing structured array from yaml based FrontMatter

Use pooled buffer in replaceShortcodes

Even as a copy at the end is needed, this consumes way less memory on Go 1.4.2:

```benchmark                           old ns/op     new ns/op     delta
BenchmarkParsePage                  145979        139964        -4.12%
BenchmarkReplaceShortcodeTokens     633574        631946        -0.26%
BenchmarkShortcodeLexer             195842        187938        -4.04%

benchmark                           old allocs     new allocs     delta
BenchmarkParsePage                  87             87             +0.00%
BenchmarkReplaceShortcodeTokens     9424           9415           -0.10%
BenchmarkShortcodeLexer             274            274            +0.00%

benchmark                           old bytes     new bytes     delta
BenchmarkParsePage                  141830        141830        +0.00%
BenchmarkReplaceShortcodeTokens     35219         25385         -27.92%
BenchmarkShortcodeLexer             30178         30177         -0.00%
```
See #1148

docs: make the named value Data File example simpler

Update datafiles.md

additional example for named data values

Fix map-order dependent menu tests

Fixes #1222

Print URL when failing menu test

See #1222

Remove unused var

Remove superfluous p-tags around shortcodes

This commit replaces the regexp driven `replaceShortcodeTokens` with a handwritten one.

It wasnt't possible to handle the p-tags case without breaking performance.

This fix actually improves in that area:

```
benchmark                           old ns/op     new ns/op     delta
BenchmarkParsePage                  142738        142667        -0.05%
BenchmarkReplaceShortcodeTokens     665590        575645        -13.51%
BenchmarkShortcodeLexer             176038        181074        +2.86%

benchmark                           old allocs     new allocs     delta
BenchmarkParsePage                  87             87             +0.00%
BenchmarkReplaceShortcodeTokens     9631           9424           -2.15%
BenchmarkShortcodeLexer             274            274            +0.00%

benchmark                           old bytes     new bytes     delta
BenchmarkParsePage                  141830        141830        +0.00%
BenchmarkReplaceShortcodeTokens     52275         35219         -32.63%
BenchmarkShortcodeLexer             30177         30178         +0.00%
```

Fixes #1148

Comment out mystery test

Fails on Travis in Go 1.3 + 1.5.

Will have to look into that one.

Revert "add preliminary support for content/index.md file to be homepage content"

This reverts commit 5f84bc02cd9706af92311cc27ae01d2ffc1410fa.

Revert "refactor and clean up site tests"

This reverts commit 99e250917ddc351d45adfeb81057ea3607d1b148.