hugolib: Camelcase ALL_CAPS vars and const in tests

See #2014

hugolib, source, tpl: Fix docs

See #2014

helpers: Rename WalkRootTooShortError to ErrWalkRootTooShort

Fix golint warning: helpers/path.go:473:5: error var
WalkRootTooShortError should have name of the form ErrFoo

See #2014

helpers: Add documentation to some Language methods

See #2014

helpers: Use iterate operator by int in Emojify

Fix golint warning: helpers/emoji.go:56:4: should replace start += 1
with start++

See #2014

commands, hugolib: Unify case of config variable names

commands, hugolib, parser, tpl: Use errors.New instead of fmt.Errorf

commands, hugolib, source, target, tpl: Get rid of some fmt statements

all: Use jww instead of fmt for printing

This is an attempt to unify method for printing.

Fix case issues with Params

There are currently several Params and case related issues floating around in Hugo.

This is very confusing for users and one of the most common support questions on the forum.

And while there have been done some great leg work in Viper etc., this is of limited value since this and similar doesn't work:

`Params.myCamelCasedParam`

Hugo has control over all the template method invocations, and can take care of all the lower-casing of the map lookup keys.

But that doesn't help with direct template lookups of type `Site.Params.TWITTER_CONFIG.USER_ID`.

This commit solves that by doing some carefully crafted modifications of the templates' AST -- lowercasing the params keys.

This is low-level work, but it's not like the template API wil change -- and this is important enough to defend such "bit fiddling".

Tests are added for all the template engines: Go templates, Ace and Amber.

Fixes #2615
Fixes #1129
Fixes #2590

docs: Add Pages to variables section

And some other minor doc fixes.

Closes #2297
Closes #2649

node to page: Re-add translations sort of regular pages

Was removed by mistake.

Updates #2297

docs: Add release notes about node to page

Updates #2297

docs: Add sections on node now being a page

Updates #2297

node to page: Fix site pages sort

Updates #2297

node to page: Fixe index page translation issues

Updates #2297

docs: Revise docs to reflect that Node is gone

Updates #2297

docs: Make the tools content page a section page

Because it is the right solution and it the avoids naming conflict with section vs page.

Updates #2297

node to page: Don't repeat the RSS title if it is the same

Updates #2297

node to page: Temporary set RSS date to zero

Updates #2297

node to page: Render aliases before pages

Some sites, Hugo docs included, have faulty alias definitions that point
to itself or another real page. These will be overwritten in the next step.

This is how it behaves in Hugo 0.17, too.

Updates #2297

node to page: Need to append theme templates

Updates #2297

node to page: Only return regular pages in home.Data.Pages

Returning all types is both confusing and too breaking.

All page types can be fetched in .Site.Pages.

Updates #2297

node to page: Final TODO-fixes

Updates #2297

node to page: Fix the Page copy()

By embeding the init sync.Once var in a pointer so we can reset it when we copy the page.

Updates #2297

node to page: Misc. TODO-fixes

Updates #2297

node to page: Handle URLs

This includes removing the error return value from Permalink and RelPermalink.

We ignore that error all over the place, so we might as well remove it.

Updates #2297

node to page: Remove Node

And misc. TODO-fixes

Updates #2297

node to page: Make Kind a string

Having a custom string type isn't worth it when it doesn't work
with `where`, `eq` etc.

Fixes #2689
Updates #2297

node to page: Rename PageType to Kind

And embed that on Page.

Updates #2297

node to page: Export GetPage to the templates

Updates #2297

node to page: Handle Date and Lastmod

Updates #2297

node to page: Add Pages to Page

As an alias to .Data.Pages for home page etc.

Also renamte NodeType to PageType and make it a string so it can be used in `where`.

Updates #2297

node to page: Make Nodes into Pages

* `.Site.Pages` now contains all page types, including sections etc.
* `.Data.Pages` will also contain "node type" pages where relevant.

Updates #2297

node to page: Refactor the build process

To make it easier to follow and understand.

Both building and rebuilding now follow a four step flow:

1. Init
2. Process
3. Assemble
4. Render

And now there are only one Build method, used for both builds and rebuilds.

Updates #2297

node to page: Handle sections with only _index.md

Updates #2297

node to page: Handle aliases on home page etc.

Updates #2297

node to page: Handle menus on home page etc.

Updates #2297

node to page: Handle taxonomies on home page etc.

Updates #2297

node to page: Add all nodes to sitemap

Updates #2297
Fixes #1303

node to page: Do not create section node for root

Because that will overwrite the home page, which is bad.

Updates #2297

node to page: Get Rebuild up to speed

Updates #2297

node to page: Fix home target path on Windows

Updates #2297

node to page: Remove unused code

Updates #2297

node to page: Handle aliases, 404, robots.txt, sitemap

Updates #2297

node to page: Handle translations

Updates #2297

node to page: Fix the page collections

Updates #2297

node to page: Use _index as identificator for the list nodes

Updates #2297

node to page: Handle RSS

Updates #2297

node to page: Create pages for nodes without content

Updates #2297

node to page: Handle taxonomy terms

Updates #2297

node to page: Handle taxonomy lists

Updates #2297

node to page: Handle sections

Updates #2297

node to page: Handle home

With refactored paginator handling.

Updates #2297

node to page: Basic outline

Updates #2297

Revert "Fix case issues with Params"

This reverts commit 239c75c7f866e8970b794a9e7bac73de46052241.

There is a ininite loop in there somewhere on my site that needs to be resolved.

Fix case issues with Params

There are currently several Params and case related issues floating around in Hugo.

This is very confusing for users and one of the most common support questions on the forum.

And while there have been done some great leg work in Viper etc., this is of limited value since this and similar doesn't work:

`Params.myCamelCasedParam`

Hugo has control over all the template method invocations, and can take care of all the lower-casing of the map lookup keys.

But that doesn't help with direct template lookups of type `Site.Params.TWITTER_CONFIG.USER_ID`.

This commit solves that by doing some carefully crafted modifications of the templates' AST -- lowercasing the params keys.

This is low-level work, but it's not like the template API wil change -- and this is important enough to defend such "bit fiddling".

Tests are added for all the template engines: Go templates, Ace and Amber.

Fixes #2615
Fixes #1129
Fixes #2590

docs: Fix list template link

docs: Add a simple list template

Fixes #2710

hugolib: Don't write zero-bytes files to disk

Fixes #2709

docs: Rename RSSlink to RSSLink

The former will be deprecated.

commands: Make benchmark command more useful

* Add information about average time, memory consumption and
allocations.
* Fix situation, when user provides memprofile and cpuprofile, but
cpuprofile will not created.

Fixes #2432

docs: Add balaramadurai.net to the showcase

vendor: Update deps

tpl: Add imageConfig function

Add imageConfig function which calls image.DecodeConfig and returns the height, width and color mode of the image. (#2677)

This allows for more advanced image shortcodes and templates such as those required by AMP.

layouts/shortcodes/amp-img.html
```
{{ $src := .Get "src" }}
{{ $config := imageConfig (printf "/static/%s" $src) }}

<amp-img src="{{$src}}"
           height="{{$config.Height}}"
           width="{{$config.Width}}"
           layout="responsive">
</amp-img>
```

source, tpl: Fix staticcheck complaints

tpl/template_funcs.go:1019:3: the surrounding loop is unconditionally terminated
source/lazy_file_reader.go:66:5: err != nil is always true for all possible
values ([nil:error] != [nil:error])

docs: Fix typos in extras/scratch.md

hugolib: Must update PathSpec on SiteInfo per language

commands, tpl: Get rid of repeating viper accesses

* all: Delete some blank lines
* commands, tpl: Get rid of repeating viper accesses

hugolib: Fix page sorting when weight is zero

Fixes #2673

docs: Add article by Zetao Yang

docs: Compress Hugo logo (hugo.png)

tpl: Golint fixes

helpers: Golint fixes

hugolib: Simplify range

docs: Update roadmap

Closes #2666

Enhance commit message guidelines

docs: Link latest change as commit in the footer

doc: Add a "Deployment with rsync" tutorial page

This is kind of a generic process and not so difficult. It seems important to me that it should be documented.

transform: Return any read or write error from Apply

commands: Move initialization of flags in separate function

And clean up flag variables.

docs: Remove non-showcase Hugo sites

I.e. sites with no mention of Hugo or hugo etc. in the HTML source.

Fixes #2655

Add GitInfo

This commit adds a `GitInfo` object to `Page` if `EnableGitInfo` is set.

It then also sets `Lastmod` for the given `Page` to the author date provided by Git.

The Git integrations should be fairly performant, but it adds "some time" to the build, somewhat depending on the Git history size.

If you want, you can run without during development and turn it on when deploying to the live server: `hugo --enableGitInfo`.

Fixes #2102

Fix page names that contain dot

changes:
    - in hugolib/page.go, `func permalink` and `func TargetPath`
      Fixed the attempt to *replace* the extension of something
      that was *already* a basename.
    - in source/file.go, `func NewFile`
      added check for allowed languages before translating filename

Fixes #2555

Revert "docs: Add bullion-investor.com to the showcase gallery"

No hugo generator tag, probably not a Hugo a site, certainly not a showcase.

This reverts commit b5bc74ca4609ce8cf77633c0f93fddc46814a35a.

docs: Add bullion-investor.com to the showcase gallery

docs: Add two articles written by Hash Borgir

Fix RSS Title regression

And add tests to make sure it doesn't happen again.

Fixes #2645

Make it clear that Path is relative to content root

Fixes #2290

Refactor Page tests

* To handle config in one place
* To use the real builder chain

Remove Wercker config

Hopefully fixes

Make Amber read from the Afero source file system

Add missing template error logging

Get rid of the rawContentCopy field of the Page struct

It is not needed, because it is only used to store temporary data during `preparePagesForRender`.

docs: Fix punctuation in content.md

- removed comma on line 16 to avoid confusion between clauses
- added period to line 24 for consistency
- clarified "read on" on line 30 to follow style above it while
  also verbally writing what the author seems to intend
- removed "You probably know what to do." on line 30 due to wordiness
  that could lead to confusion and a drag in reading speed

docs: Add clearhaus.com to the showcase

docs: Fix typos in content section

- changed preposition into intended infinitive for syntactical clarity
- removed "easily" as it doesn't describe anything technical and is
  confusing (which is why the author may have used a preposition)

Remove now superfluous lowercasing

See #2615
See #1129

vendor: Update Viper

all: Unify case of config variable names

All config variables starts with low-case and uses camelCase.

If there is abbreviation at the beginning of the name, the whole
abbreviation will be written in low-case.
If there is abbreviation at the end of the name, the
whole abbreviation will be written in upper-case.
For example, rssURI.