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.

Handle ToC before handling shortcodes

Fixes #2433

tpl: Fix comment

Avoid reading from Viper for path and URL funcs

The gain, given the "real sites benchmark" below, is obvious:

```
benchmark           old ns/op       new ns/op       delta
BenchmarkHugo-4     14497594101     13084156335     -9.75%

benchmark           old allocs     new allocs     delta
BenchmarkHugo-4     57404335       48282002       -15.89%

benchmark           old bytes       new bytes      delta
BenchmarkHugo-4     9933505624      9721984424     -2.13%
```

Fixes #2495

docs: Clarify installation of themes

docs: Improve instructions in quickstart.md

docs: Add dmitriid.com to the showcase

Bump Travis to Go 1.7.3

commands: Do not print error on missing unknown dirs

See #2602

commands: Only watch relevant themes dir

The same behavior as for the root project.

Fixes #2602

Add page context to error logging in rendering

Add logging of the errors/warnings which rst2html outputs to its stderr
stream when rendering rst documents. Note that rst2html outputs warnings
and errors to stderr but it also adds them to the generated html. ->
hugo logs everything in stderr as error.

Add / complete adding page context (path to file being rendered) to
anything logged by getRstContent and getAsciidocContent.

See #2570

Fix a more summary corner case

Also refactor the rendering pages test to accept more than one page source per test run, which wasn't really needed for this issue, but may be in the future.

Closes #2586
Fixes #2538

Consolidate the Param methods

Maps in Viper, Hugo's config backing store, is now properly lower-cased not just on top level, the current situation.

While this is mostly a good thing, as you don't need to know the original casing to look up a value, it will be breaking for people doing direct lookups in the ´Site.Params` map.

We will try to find a solution to this "breakage", but the recommended method to get params values is via the `.Param` methods.

This method is now implemented on `Node`, `Page` and `Site` and is case-insensitive:

* Use `.Param "someKey" ` if you want page param with fall back to site param if not found on page.
* Use `.Site.Param "someKey"` to get a site param

See #2590

docs: Add singular/plural i18n example

docs: Add christianmendoza.me to the showcase

docs: Add fixatom.com to the showcase

docs: Add hugojoomla to the tools section

docs: Remove merge artifact

helpers: Slight improvement of ToLowerMap

See #2581

Fix case issue Viper vs Blackfriday config

There are still work to be done in the case department, but that will have to be another day.

Fixes #2581
See https://github.com/spf13/viper/issues/261

docs: Update link for Ace template site