hugolib, output: Handle aliases for all HTML formats

hugolib: Update site stats to take output formats into account

Add custom protocol support in Permalink

media, output: Add Calendar type

hugolib: Read default output formats from site config

hugolib, media: Make the MediaType available to the templates

hugolib, output: Add Rel to the output format

To make it super-easy to create rel-links.

docs: Move the rough custom output formats spec to docs

This isn't meant to be the final useer docs on this feature!

hugolib: Add OutputFormats with permalinks to Page

output: Rework the base template logic

Extract the logic to a testable function and add support for custom output types.

Fixes #2995

hubolib: Pick layout per output format

hugolib: Fix layout lookup order for Render func

Will have to fix this in a better way later in relation to the non-renderable pages.

But this commit brings the Hugo Benchmark down to "only slightly slower" than master.

```
benchmark           old ns/op       new ns/op       delta
BenchmarkHugo-4     10074504521     10071236251     -0.03%

benchmark           old allocs     new allocs     delta
BenchmarkHugo-4     43623091       49271859       +12.95%

benchmark           old bytes      new bytes      delta
BenchmarkHugo-4     9468322704     9725848376     +2.72%
```

Which is something we can work with.

output: Speed up layout calculations

```
BenchmarkLayout-4     4883          497           -89.82%

benchmark             old allocs     new allocs     delta
BenchmarkLayout-4     18             1              -94.44%

benchmark             old bytes     new bytes     delta
BenchmarkLayout-4     1624          32            -98.03%
```

hugolib: Speed up URL handling

hugolib: Remove siteWriter

hugolib: Pull all alias handling into one file

Refactor layout resolve to a descriptor/adapter pattern

Rename OutputType to OutputFormat

hugolib: Refactor/-work the permalink/target path logic

This is a pretty fundamental change in Hugo, but absolutely needed if we should have any hope of getting "multiple outputs" done.

This commit's goal is to say:

* Every file target path is created by `createTargetPath`, i.e. one function for all.
* That function takes every page and site parameter into account, to avoid fragile string parsing to uglify etc. later on.
* The path creation logic has full test coverage.
* All permalinks, paginator URLs etc. are then built on top of that same logic.

Fixes #1252
Fixes #2110
Closes #2374
Fixes #1885
Fixes #3102
Fixes #3179
Fixes #1641
Fixes #1989

Implement the first generic JSON output testcase

hugolib, output: Incorporate suffix and type in layout resolve

And remove some now superflous and hard to maintain tests.

hugolib: Add basic setup for output def per Kind

hugolib: Revert to using Page as the render chan type

Changing it to PageOutput was a mistake. You may think that the increased parallelism should be a good thing.

But not so much with the increased lock contention and more complex concurrency model.

hugolib: Remove the copying in the renderRSS

hugolib: Put back taxonomy term paginator logic lost in rebase

hugolib, output: Add theme logic to LayoutHandler

hugolib: Add a PageOutput wrapper for rendering

hugolob: A first incorporation of output types in rendering

hugolib: Use the new layout logic in Page

output: Move layout logic to the output package

output: Add output type

Add MediaType and a crude implementation

See #2828

Exit -1 on ERROR in non-global logger

Fixes #3239

Revert "tplimpl: return an error on unsupported type in isSet"

This breaks the theme site and lots of themes, so we will have to thinkg a little harder about this one.

This reverts commit 74ea81b885adc64d0194df461cbc85667294d16e.

Change RSS description from full .Content to .Summary

hugolib: Correctly identify "my_index_page.md"

The above example was earlier identified as a section page and not a regular page.

Fixes #3234

snapcraft: Bump version to 0.20-DEV

snapcraft: Add vendoring support

Also, build with go1.8, run "make test", and strip the binary.

Fixes #3226

docs: Add Hugo SFTP Upload to the tools section

/cc @rdwatters

commands: Fix case of createpath in new.go

create: Delete redundant viper calls

Also make easier to read the code

docs: Remove dead links, consistent formatting...

This page was a real chore chore on the POC. In the event that a new doc site won't be approved by v20, this will at least clean up the broken links I found during my audit. I would like to eventually create this as a [data file](https://github.com/spf13/hugo/pull/2508#commitcomment-18705617) since md tables get unwieldy pretty quickly.

docs: Fix typo in templates/functions.md (#3214)

limitted → limited

commands: Keep "." directories on cleanDestinationDir

Fixes #3208

docs: Add bharathpalavalli.com to the showcase

parser: Improve TOML frontmatter parser performance

Difference between toml.Load(string(datum)) and
toml.LoadReader(bytes.NewReader(datum)):
benchmark           old ns/op     new ns/op     delta
BenchmarkLoad-4     82068         78489         -4.36%

benchmark           old allocs     new allocs     delta
BenchmarkLoad-4     494            493            -0.20%

benchmark           old bytes     new bytes     delta
BenchmarkLoad-4     17009         16913         -0.56%

Removing .Site.Recent

Per forum:

https://discuss.gohugo.io/t/site-recent-deprecated-or-removed/5851/2

Revert "Add support for a flatter and simpler language file structure"

This reverts commit 0e75f6e7b14ea916b368da053327d352606ab09f.

Revert "vendor: Fix broken i18m definition"

This reverts commit 7c48ad57a9103619f4d34989851c7dcd92777186.

vendor: Fix broken i18m definition

Add support for a flatter and simpler language file structure

See https://github.com/nicksnyder/go-i18n/issues/62
See #2577

Revert "helpers: Add a Debug method to DistinctLogger"

Not needed.

This reverts commit 4382a8a6a030520d9f094b3d7bb8f3ae3f08b187.

docs: Add tibobeijen.nl to site showcase

helpers: Add a Debug method to DistinctLogger

Case insensitive translation of the 'more' tag when importing from Jekyll

docs: Fix documentation of non-existent 'editor' config

docs: Change OS X to macOS in README and CONTRIBUTING

docs: Fix CONTRIBUTING.md

Update to new go-toml API

Closes #3142

docs: Update contributing guides

Add vendoring and make targets.  Require Go 1.8+ and remove mention of
GOPATH (just assume $HOME/go).

Due to time contraints, the contributing tutorial was only slightly
updated to make obvious corrections.

Fixes #3153

docs: Optimize 11 showcase thumbnail images

docs: Add Linux distro-specific installation instructions

Backported from https://hugodocs.info/getting-started/installing/
with added mention for Fedora and Red Hat.

docs: Note Hugo as Snap package can write only inside $HOME

Backported from https://hugodocs.info/getting-started/installing/

Fixes #3143

docs: Replace Mac OS X with macOS in three places

docs: Add lucumt.info to showcase

parser: Accept JSON frontmatter without leading "{\n"

Accept JSON frontmatter without leading "{\n" so that one line
frontmatters such as `{"param":"paramvalue"}` no longer silently render
empty html.

commands: Improve jekyll import date format

Allow both yyyy-mm-dd and yyyy-m-d formats in jekyll markdown
file names.

docs: Improve command reference page

tpl: Add union template func

docs: Add Android to README

hugolib: Fix reloading corner cases for shortcodes

This commit fixes two different, but related issues:

1) Live-reload when a new shortcode was defined in the content file before the shortcode itself was created.
2) Live-reload when a newly defined shortcode changed its "inner content" status.

This commit also improves the shortcode related error messages to include the full path to the content file in question.

Fixes #3156

commands: t.Error => t.Errorf

parser: Refactor frontmatter parser and add tests

Lots of cleanups here:

- Refactor InterfaceToConfig and InterfaceToFrontMatter to use io.Writer.
- Simplify InterfaceToFrontMatter by wrapping InterfaceToConfig.
- Export FrontmatterType since we return it in DetectFrontMatter.
- Refactor removeTOMLIdentifier to avoid blindly replacing "+++".
- Update HandleJSONMetaData to return an empty map on nil input.
- Updates vendored goorgeous package and test for org-mode frontmatter.
- Add tests and godoc comments.

Coverage for parser package increased from 45.2% to 85.2%.

hugolib: Clean up redundant frontmatter error logging

Fixes #3157

docs: Explain themes dir in quickstart guide

Themes is currently not included in the description that follows `tree -a` even
though it is autogenerated for you by `new site`.

docs: Add myearworms.com to the showcase

hugolib: Default rssLimit to unlimited

Fixes #3145

all: Fix some govet complaints

Update appveyor config

Remove "image" setting as the "WMF 5" image is deprecated.

Fixes #3061, #3142

tplimpl: Add built-in print funcs to FuncMap

Add print, printf, and println to the Hugo FuncMap so that they are
accessible to the apply template func.

Updates #3139

hugolib: Don't report taxonomy count if disabled

hugolib: Remove unnecessary params

Found by github.com/mvdan/unparam

docs: Add enjoyable.recipes to the showcase

hugolib: Populate the taxonomy term Pages list

Previously this was left empty, but it is very handy to have a list
of term pages for a given taxonomy.  This list can now be paginated
like other page lists.  It makes it possible to render summary
content from each terms index page for instance.  It also makes it
possible to sort the term pages in the same way that other page
lists can be sorted.  An RSS feed is now generated for
KindTaxonomyTerm pages as well.

This also fixes a bug in HugoSites.createMissingPages.  Previously
it would only check for existing KindTaxonomyTerm pages if the
taxonomy had any terms defined.  So for a taxonomy with no terms
but a taxonomy terms page it would generate a second empty terms
page.

hugolib: Add a temporary workaround for page.copy() data race

See ##3129

docs: Correct toml syntax in Github deploy tutorial

hugolib, target: Rework/move the target package

This relates to #3123.

The interfaces and types in `target` made sense at some point, but now this package is too restricted to a hardcoded set of media types.

The overall current logic:

* Create a file path based on some `Translator` with some hardcoded logic handling uglyURLs, hardcoded html suffix etc.
* In in some cases (alias), a template is applied to create the alias file.
* Then the content is written to destination.

One could argue that it is the last bullet that is the actual core responsibility.

This commit fixes that by moving the `hugolib`-related logic where it belong, and simplify the code, i.e. remove the abstractions.

This code will most certainly evolve once we start on #3123, but now it is at least possible to understand where to start.

Fixes #3123

vendor: Update cast

hugolib: Fix HugoSites.createMissingPages

Previously it would only check for existing KindTaxonomyTerm pages
if the taxonomy had any terms defined.  So for a taxonomy with no terms
but a taxonomy terms page it would generate a second empty terms page.

docs: Add blog post from After Dark creator

hugolib: Add section template baseof test case

Closes #2995
See #3116

docs: Add new section list lookup alternative

Updates #3116

hugolib: Add /layouts/SECTION/list.html to template lookup

Fixes #3116

helpers: Return partially cleaned URL in case of error in URLPrep anyway

Closes #2987

tplimpl: return an error on unsupported type in isSet

Fixes #3092

helpers: Remove unused arg

hugolib: Fix broken test

See #2977

docs: Add some more quotes

hugolib: Make sure that empty terms lists are still created

Fixes #2977

Handle Hugo version strings with patch level

Fixes #3025