Add index reference to go template primer doc page

Related to @bjornerik 's answer in this discussion: http://discuss.gohugo.io/t/inserting-data-from-data-file-into-content-file-newbie-question/1002/3 ... I figured I'd make myself useful and add the reference to the index function, on the go template primer page.

Also, I moved the reference links to the bottom.

A general comment: as good as these docs are, the primer at this point makes some assumptions about audience knowledge, so some might find it lacking. Once I understand better, I might make some more clarifying edits.

Fix typo in test

Return error from HandleShortcodes

To be able to test for it.

Print ERROR on theme vs Hugo version mismatch

Fixes #1070

Clarify partials folder subfolders

A couple of edits to clarify that the layout/partials folder can contain arbitrarily-named subfolders, since I found the examples using ``{{ partial "post/tag/list" . }}`` confusing. Some folders are named specifically to work a certain way with hugo, but although the examples use key functional section and taxonomy names like post and tag, it does not matter what they are called. Hopefully this will help other newbs.

Single rather than double backticks in types.md

Whoops, I had the new hugo new as double backticks but it appears only single are needed.

Clarify hugo new command in types.md

Elsewhere in the docs commands are entered as code, so to be consistent with that, added backticks and the word hugo.

Fix broken Travis tests

No idea why these suddenly starts to fail.

Do not fail on unknown files in /data

Fixes #1068

pagination: export pager to make Golint happy

Use fmt.Errorf to make Golint happy

Add shortcut to Scratch from shortcode

doc: clarify Scratch usage in shortcodes

Check spelling and some minor additions to Ace doc

Add doc for Ace templates

Fixes #1063

Expand the ACE base template lookup pattern

The previous implementation didn't easily support the use case "I want one base template for the single pages, another for the rest".

The new lookup order is:

1. <current-path>/<template-name>-baseof.ace, e.g. list-baseof.ace
2. <current-path>/baseof.ace
3. _default/<template-name>-baseof.ace, e.g. list-baseof.ace.
4. _default/baseof.ace

Polish func naming in shortcode handling

Remove unused types Shortcode and ShortcodeFunc

Only write highlight to cache when CacheDir is set

To avoid writing cache files when testing.

Fix broken Highlight test

Temporarily disable Highlight test

Add more options to highlight

Fixes #1021

Fix potential Windows path issue with Pygments cache

Added isso as a Disqus alternative to the docs

Hi,

I'm using isso with my hugo blog which works just fine.
I think this should be added to the docs :)

Thanks!

Add "Google Cloud Storage" article to docs Press page

See #1055

Typo in mathjax.md

Add Google Cloud Storage to doc

Fix spelling mistake in comment

Add custom Windows mousestrap message

Fixes #1022

Remove section about the buildDate being configurable

It isn't.

Fix README part about missing Windows tests

We now have AppVeyor.

Add git commit message guideline

Also rearranged the contribution section to get more attention to the important stuff.

tpl: split template.go

The template funcs get their own file. This prevents having to scroll miles to get to the template infrastructure.

Document getenv template function

Add `getenv` to the template function documentation.

Add a section comparing the 'build' and 'server'

One of the first things that new users have to understand is the
difference between Hugo as a web server and Hugo as a web site
generator. Issue #852 asked for documentation to make that clear.

This patch updates the overview page with that information. It will
seem repetitive to users that understand the difference. Weigh that
against the needs of those that don't.

Reference #852

Sort function names in templates documentation

The documentation on the functions is long.  It is easier to find
a function name when they are sorted within the sections.

Fixes #981

docs: how to compile on mac, fix minor errors

helpers: add some missing documentation

Fix the last Go Vet error

hugolib: make Page implement the ReaderFrom interface

helpers: fix some go vet errors

Return early from DistinctErrorLogger's Printf

List directories being watched when server is run

Fixes part of issue 1030. Previously hugo only listed the content
directory as being watched. Now we list all files being watched
according to `commands.getDirList()`. We also introduce a RemoveSubpaths
function and test in the helpers module to reduce noise in the command
line output by not showing subdirectories of ones already being watched.

For example, instead of:
`Watching for changes in $HOME/blog/content`
We get:
`Watching for changes in
$HOME/blog/{data,content,layouts,static,themes/my-theme}`

documentation: mention data files under liverload

Remove paragraph tags produced by markdownify

Fixes #1025

Make contentTransformer names consistent

Return error on wrong use of the Paginator

`Paginate`now returns error when

1) `.Paginate` is called after `.Paginator`
2) `.Paginate` is repeatedly called with different arguments

This should help remove some confusion.

This commit also introduces DistinctErrorLogger, to prevent spamming the log for duplicate rendering errors from the pagers.

Fixes #993

Add pager size argument to paginator methods

Fixes #1013

Updates documentation with instructions for a Windows computer

Adds step-by-step instructions for installing from the official
tarball.

Fixes #1007

Capitalize singular

Added in #523 it's ``Data.Singular``

Updates documentation with instructions for a Mac

Adds step-by-step instructions for installing from both brew and
the official tarball. Not sure if steps for installing from source
belong here, so left them out.

Fixes #1005

Update embedded rss.xml code in the docs

Add some more corner tests for ReaderContains

Fix shortcode handling in ToC

Fixes #1010

Handle views in combo with Ace base templates

As views looks like a regular template, but doesn't need a base template, we have to look inside it.

Altough really not needed by this commit, reading the full file content into memory just to do a substring search is a waste.
So this commit implements a `ReaderContains` func that in most cases should be much faster than doing an `ioutil.ReadAll` and `bytes.Contains`:

```
benchmark                   old ns/op     new ns/op     delta
BenchmarkReaderContains     78452         20260         -74.18%

benchmark                   old allocs     new allocs     delta
BenchmarkReaderContains     46             20             -56.52%

benchmark                   old bytes     new bytes     delta
BenchmarkReaderContains     46496         1258          -97.29%
```

Fixes #999

Hash all pygments parameters.

Ensures that Hugo rehighlights source code whenever one of the
highlighting options changes.

Use helpers.FilePathSeparator const

Fix section name guessing on Windows

Cache pygments rendering between runs

Fixes #1000

Add support for Ace base and inner templates

Fixes #994
Fixes #511

Add missing ".adoc" extension in handler_page.go

Commit 358dcce supposedly added ".adoc" extension recognition
for AsciiDoc, but one place was missed.

Thanks to @sjfloat for reporting the bug!
See discussions at #470.

Change to variadic int args in Slicestr

Makes for a better template api.

Implement substr template function

Its behavior is similar to that in JavaScript
with special handling of negative length as found in in PHP.

Fixes #991

Rename Slice to Slicestr

Fixes #990

Polish Slice doc

Rename Substr to Slice

That is whas was implemented, not Substr.

Also make the API more similar to Go's internal slice by making both the start and end indices optional.

See #990

Polish Substr and Split tests

Add Substr and Split template functions

Both of these can take any type the cast lib can turn into a string.

Pull Data Files tests into its own file

Format docs

Rename interface contentRewriter to contentTransformer

Is is a much better name.

Change safeHTtml to safeHTML in sitemap template

template: add some missing test cases for First

transform: remove some superfluous int conversions

Remove URL param from exported AbsURL methods

This is to make it clear that there is only one URL in play,
the BaseURL.

Un-export ContentReWriter

Write to rotating ContentReWriter in transformer chain

This commit adds the interface ContentReWriter in the tranformer chain.

This is backed by two pooled byte buffers, alternating between being the reader or the writer.

This keeps the performance characteristic of the old implementation, but in a thread safe way.

Fixes #911

Benchmark old vs new:

benchmark              old ns/op     new ns/op     delta
BenchmarkAbsURL        17614         17384         -1.31%
BenchmarkXMLAbsURL     9431          9248          -1.94%

benchmark              old allocs     new allocs     delta
BenchmarkAbsURL        24             28             +16.67%
BenchmarkXMLAbsURL     12             14             +16.67%

benchmark              old bytes     new bytes     delta
BenchmarkAbsURL        3295          3424          +3.92%
BenchmarkXMLAbsURL     1954          1987          +1.69%

Comment out shaky Seq test

Calculate the next Hugo version in Deprecated

Deprecation will be an ongoing activity for many future versions.

Refactor Hugo version

Put version handling into the helpers package so it can be used by many,
and split version and suffix to make it possible to calculate the next Hugo version.

Add UrlPath to the deprecated list

Improve type handling in Seq

Update Hugo docs with the initialisms suggested by golint

In particular:

 * .Url → .URL (for node, menu and paginator)
 * .Site.BaseUrl → .Site.BaseURL
 * getJson → getJSON
 * getCsv → getCSV
 * safeHtml → safeHTML
 * safeCss → safeCSS
 * safeUrl → safeURL

Continued effort in fixing #959.

More initialism corrections (golint)

Thanks to @bep's new, brilliant helpers.Deprecated() function,
the following functions or variables are transitioned to their
new names, preserving backward compatibility for v0.14
and warning the user of upcoming obsolescence in v0.15:

 * .Url → .URL (for node, menu and paginator)
 * .Site.BaseUrl → .Site.BaseURL
 * .Site.Indexes → .Site.Taxonomies
 * .Site.Recent → .Site.Pages
 * getJson → getJSON
 * getCsv → getCSV
 * safeHtml → safeHTML
 * safeCss → safeCSS
 * safeUrl → safeURL

Also fix related initialisms in strings and comments.

Continued effort in fixing #959.

Press: Add "Migrating to Hugo From Octopress" by Nathan LeClaire

[Docs] Copyedit http://gohugo.io/extras/dynamiccontent/

Use ReaderToString in site tests

Since a string is what's really needed.

Fix crossrefs on Windows

Have to convert path slashes to file path slashes before the URL path is compared to a file path.

Fixes #957

Add "getenv" as an wrapper for os.Getenv

Add a wrapper for the os.Getenv function. The
wrapper takes as input a string that is assumed to be an exported
variable name.

Fixes #977

removed duplicate word in readme

Revert "Added image support to the sitemap.xml template"

This reverts commit 3c147bd41922c4f0ac81bc1e1f2ffab8093d5d1c.

Fixes #972

Added image support to the sitemap.xml template

Conflicts:
tpl/template_embedded.go

Add Seq template func

Very similar to GNU's seq.

Fixes #552

Conflicts:
tpl/template.go

Experimental AsciiDoc support with external helpers

See #470

 * Based on existing support for reStructuredText files

 * Handles content files with extensions `.asciidoc` and `.ad`

 * Pipes content through `asciidoctor --safe -`.
   If `asciidoctor` is not installed, then `asciidoc --safe -`.

 * To make sure `asciidoctor` or `asciidoc` is found, after adding
   a piece of AsciiDoc content, run `hugo` with the `-v` flag
   and look for this message:

        INFO: 2015/01/23 Rendering with /usr/bin/asciidoctor ...

Caveats:

 * The final "Last updated" timestamp is currently not stripped.

 * When `hugo` is run with `-v`, you may see a lot of these messages

        INFO: 2015/01/23 Rendering with /usr/bin/asciidoctor ...

   if you have lots of `*.ad`, `*.adoc` or `*.asciidoc` files.

 * Some versions of `asciidoc` may have trouble with its safe mode.
   To test if you are affected, try this:

        $ echo "Hello" | asciidoc --safe -
        asciidoc: ERROR: unsafe: ifeval invalid
        asciidoc: FAILED: ifeval invalid safe document

   If so, I recommend that you install `asciidoctor` instead.

Feedback and patches welcome!

Ideally, we should be using https://github.com/VonC/asciidocgo,
@VonC's wonderful Go implementation of Asciidoctor.  However,
there is still a bit of work needed for asciidocgo to expose
its API so that Hugo can actually use it.

Until then, hope this "experimental AsciiDoc support through external
helpers" can serve as a stopgap solution for our community. :-)

2015-01-30: Updated for the replaceShortcodeTokens() syntax change
2015-02-21: Add `.adoc` extension as suggested by @Fale

Conflicts:
helpers/content.go

Do not ERROR-log missing /data dir

Fixes #930

source: add some test cases for File

Add double checking in Deprecated

To prevent possible duplicate log statements.

Add deprecated logger

[Docs] Update and expand http://gohugo.io/overview/usage/

The `hugo help` output as shown in http://gohugo.io/overview/usage/
was not yet updated for v0.13. Thanks to @alebaffa for the heads up!

Also:
 - Clarify that, after using `hugo server`, the bare `hugo` command
   need to be run before deployment.
 - Add a section on running `hugo` as production web server,
   and add links to two blog posts of two Hugo users sharing
   their experience.

Partially fixes: #852 and #937

Update press coverage: Fix URL; new tutorial in Chinese