Fix OpenGraph image fallback to site params

Signed-off-by: Elliot Murphy <statik@users.noreply.github.com>

Support numeric sort in ByParam

With this commit ByParam takes into account a type of a value under a
key. If both values are numeric then they're coerced into float64 and
then get compared.
If any value isn't numeric, for example it's nil or string, then both
values coerced into string and get compared as strings
(lexicographicaly)

Nil values are always sent to the end.

Numeric values confirm to any type listed below:
uint8, uint16, uint32, uint64, int, int8, int16, int32, int64, float32, float64

Closes #5305

Fix Params case handling in the new site global

Fixes #5615

Make hugo server -t work again

This commit solves an issue where hugo would ignore the cli -t flag
and only use a theme defined in config.toml.

Also allow -t flag to accept a string slice.

Closes #5569
Closes #5061
Related #4868

Add configFile(s) back to the watch list after RENAME event too

Alleviates #5205

Remove historical rssURI config

Use subtests with server_test.go

Use Golang's subtests to provide a convenient way
to run specific tests.
Example:
go test -run=TestFixURL/Basic_production

resources: Move resource interfaces into its own package

resource: Move resource processors into sub-packages

Update _index.md

Corrects misspelling of sync (synch)

hugolib: Restore 0.48 slash handling in taxonomies

Fixes #5571

Revert " Fix handling of taxonomy terms containing slashes"

See #4090
See #5571

This reverts commit fff132537b4094221f4f099e2251f3cda613060f.

Update go.sum

Revert "hugolib: Restore taxonomy term path separation"

See #5571

This reverts commit 9ce0a1fb7011bd75eb0e2262e35354c49ce98ac5.

tpl: Fix reflect

Fixes #5564

cache/namedmemcache: Fix data race

Update Chroma

Fixes #4993

Make docshelper run again

Fixes #5568

releaser: Use Git short commit in release binaries

Fixes #5562

releaser: Bump Goreleaser version

Merge commit '978856e2ad12d2bcaf37bb9e31f806b30a4c42f4'

Squashed 'docs/' changes from bd91d1cfd..785e375f5

785e375f5 Change 'my-another-post' to 'my-other-post'
ba9a69d25 Update reflect.IsSlice.md
806344258 Update reflect.IsMap.md
757c0dafa Update index.md
d3f20a2d5 Update index.md
9952e72a0 Formatting
70458ccf2 Formatting
7e0dd3969 Merge branch 'config-dir'
06a5c11fc Release 0.53
01c00229f releaser: Prepare repository for 0.54-DEV
29b223f78 releaser: Add release notes to /docs for release of 0.53
4f61d1194 releaser: Bump versions for release of 0.53
320a0ac68 Refactor config below /config
ec16b611e docs: Adjust CSV example
cecf97dfc Rename CSV option from comma to delimiter
18d06df58 docs: Document transform.Unmarshal
fdace78b5 docs: Regenerate CLI docs
b8f84ac59 hugolib: Add .Name as a shortcode variable
6612dd1b8 Merge commit '5a83bf314f4c0ce1d61341e0a1df21c9998e8154'
9b211089f docs: Regenerate CLI docs
9af46af3c Merge commit 'eb16165694f868d73e57b6aed5c26ba5e98229de'
12f46f356 tpl: Add reflect namespace

git-subtree-dir: docs
git-subtree-split: 785e375f577394c6f782ef51796e2efe88d52cbb

releaser: Prepare repository for 0.54-DEV

[ci skip]

releaser: Add release notes to /docs for release of 0.53

[ci skip]

releaser: Bump versions for release of 0.53

[ci skip]

release: Fix goreleaser config

Release 0.53

tpl/transform: Include options in cache key

See #5555

docs: Adjust CSV example

See #5555

Rename CSV option from comma to delimiter

See #5555

docs: Document transform.Unmarshal

Fixes #5556

hugolib: Adjust test

See #5544

docs: Regenerate CLI docs

Fixes #5544

tpl/transform: Simplify transform.Unmarshal func

See #5428

Add CSV support to transform.Unmarshal

Fixes #5555

tpl/transform: Add transform.Unmarshal func

Fixes #5428

Prevent resource publishing for transformed inline resources

That is, if only `.Content` is accessed.

This means that, for a transformed resource to be published to `/public`, you need to access either `.RelPermalink` or `Permalink`.

Fixes #4944

hugolib: Add .Name as a shortcode variable

Fixes #5546

Squashed 'docs/' changes from d1cf9adc4..bd91d1cfd

bd91d1cfd Fix typo
0d45ea9cf Fix order of arguments in another strings.TrimLeft example
0982f65c1 Fix the order of arguments to strings.TrimRight
f1f9b7cd6 Arguments in example
5d9c7327f Fix shortcode example escape chars

git-subtree-dir: docs
git-subtree-split: bd91d1cfddf87fa693c1e2e7a2de555d2cee19f3

Merge commit '5a83bf314f4c0ce1d61341e0a1df21c9998e8154'

hugolib: Improve logic of output path trimming

Fixes #4666

snap: Revert build-snap to 1.11/stable channel for go

This is to fix the following snap build error:

    Failed to install or refresh a snap: 'go' does not exist
    or is not available on the desired channel '1.11.4/stable'.
    Use `snap info go` to get a list of channels the snap is available on.

`snap info go` reveals that the '1.11/stable' channel automatically
follows the latest minor point release as it becomes available.

commands: Remove the benchmark command

It's not particulary useful, and when we start to get bug reports about it, it is easier to remove it.

Closes #5543

Move the emoji parsing to pageparser

This avoids double parsing the page content when `enableEmoji=true`.

This commit also adds some general improvements to the parser, making it in general much faster:

```bash
benchmark                     old ns/op     new ns/op     delta
BenchmarkShortcodeLexer-4     90258         101730        +12.71%
BenchmarkParse-4              148940        15037         -89.90%

benchmark                     old allocs     new allocs     delta
BenchmarkShortcodeLexer-4     456            700            +53.51%
BenchmarkParse-4              28             33             +17.86%

benchmark                     old bytes     new bytes     delta
BenchmarkShortcodeLexer-4     69875         81014         +15.94%
BenchmarkParse-4              8128          8304          +2.17%
```

Running some site benchmarks with Emoji support turned on:

```bash
benchmark                                                                                     old ns/op     new ns/op     delta
BenchmarkSiteBuilding/TOML,num_langs=3,num_pages=5000,tags_per_page=5,shortcodes,render-4     924556797     818115620     -11.51%

benchmark                                                                                     old allocs     new allocs     delta
BenchmarkSiteBuilding/TOML,num_langs=3,num_pages=5000,tags_per_page=5,shortcodes,render-4     4112613        4133787        +0.51%

benchmark                                                                                     old bytes     new bytes     delta
BenchmarkSiteBuilding/TOML,num_langs=3,num_pages=5000,tags_per_page=5,shortcodes,render-4     426982864     424363832     -0.61%
```

Fixes #5534

parser/pageparser: Split the page lexer into some more files

See #5534

hugolib: Enable Emoji in site benchmark

parser/pageparser: Add a benchmark

tpl: Fix case handling in cast params

Fixes #5538

Update to Go 1.11.4

Fixes #5524

releaser: Get ldflags for build date etc. in line for all builds

Closes #5539
Closes ##5388

transform/urlreplacers: Simplify implementation

transform/urlreplacers: Support unquoted URLs in canonifyURLs replacer

Fixes #5529

hugolib: Remove "double layout" lookup

Fixes #5390

Fix "failed to create file caches from configuration: file exists" on Windows

Fixes #5497

hugolib: Restore taxonomy term path separation

Fixes #5513

importer: fix jekyll import highlight options

docs: Regenerate CLI docs

Fixes #5507

Merge commit 'eb16165694f868d73e57b6aed5c26ba5e98229de'

Squashed 'docs/' changes from 37095d540..d1cf9adc4

d1cf9adc4 Fix typo
26e10a690 Fix the name and arg mismatch between partial defn and call
2db0e53cd Merge commit '9c36cff15224f6cbd19058ad61311229b7a23c83'
9c36cff15 Squashed 'themes/gohugoioTheme/' changes from 68ddff44..b8202f53
4b021eff8 Update lang.Merge.md
b37af2916 Add title to yaml
a9a281233 Fixed incorrect usage of the code-toggle shortcode
4560a0169 Update Warning for Theme Links (#676)
0305e3c6b Document .File.ContentBaseName
6d30c5aa1 Update configuration.md
158df174a Document .Sites and .Sites.First
0c0f583b8 Add stale config
e2531afd8 Document path template functions
4dd779057 Clarify that partialCached is per site/language
19e5bbe0c Update index.md
44b000857 Add missing dot
a41300cf9 Release 0.52
2d1d92b88 Merge branch 'temp52'
c5925250d releaser: Prepare repository for 0.53-DEV
d000b04a2 releaser: Add release notes to /docs for release of 0.52
4bb983a0a releaser: Bump versions for release of 0.52
36736ca28 tpl: Add "param" shortcode
378677aa6 Add Elasticsearch/bonsai.io to services doc.
4c3fd4fa4 docs: Document inline shortcodes
6c64c374c Whitelist CSS modules from purge
817a872b9 Improve search icon position
cf86ff1c7 Add minification and resource cache clear to build command
fd77e8df3 Update asset dependencies and adopt Hugo Pipes
cdbe97e8c Update render.md
b0e279220 git command to update submodule to latest
a1cb98c12 cache/filecache: Add a :project placeholder
07c1b2b46 cache/filecache: Use time.Duration for maxAge
ffa9b165e Add AND as a title
6e7733b40 Add OR as a sub title to make it easier to find in search
72b6791a1 docs: Document the new file cache
714d3ca91 Fix minification issues
cd1e961da Revert "Add Elasticsearch/bonsai.io to services doc."
15a0cda6e Add Elasticsearch/bonsai.io to services doc.
f931d86de Release 0.51
e2ffe867a Merge branch 'temp51'
423e7f5c8 releaser: Prepare repository for 0.52-DEV
c6f2d6ae1 releaser: Add release notes to /docs for release of 0.51
5bbb556dc releaser: Bump versions for release of 0.51
3b2b172b9 docs: Document shortcode error handling
b8672f3d4 docs: Document symdiff
4bc6071e6 docs: Document complement
d1baab752 docs: Re-generate CLI docs
9ea667e24 Revert "tpl: Update Jsonify to return pretty-print output"
ce5a1403d docs: Regenerate the docs helper
99a1f4a94 Fix note for reserved partial name(starting with -> including).
eba3cbc42 fix accidentally modification on paragraph.
3eebd98c3 Add note for reserved partial name.
40b881cc2 Document templates.Exists
b5c3bcd3b Update multilingual.md
61c59c67e Fix misspelling (#648)
f21d8c4a4 Correct minor typo (#5372)
e967001b9 Release 0.50
685fd6b08 releaser: Prepare repository for 0.51-DEV
f245a9faa releaser: Add release notes to /docs for release of 0.50
4354da30d releaser: Bump versions for release of 0.50
feaa05469 docs: Regenerate CLI docs
5c724200c Merge commit 'd6a4af7018e8618944a6471ceeb7aae1d4df6afa'
2ddab36c2 Merge commit '74309fe5699a595080fdb3a14711e0869babce99'
8cf296a7c docs: Regenerate CLI docs
9097683dd tpl: Update Jsonify to return pretty-print output

git-subtree-dir: docs
git-subtree-split: d1cf9adc412245c96d9d32592a903370d3972aef

Add /config dir support

This commit adds support for a configuration directory (default `config`). The different pieces in this puzzle are:

* A new `--environment` (or `-e`) flag. This can also be set with the `HUGO_ENVIRONMENT` OS environment variable. The value for `environment` defaults to `production` when running `hugo` and `development` when running `hugo server`. You can set it to any value you want (e.g. `hugo server -e "Sensible Environment"`), but as it is used to load configuration from the file system, the letter case may be important. You can get this value in your templates with `{{ hugo.Environment }}`.
* A new `--configDir` flag (defaults to `config` below your project). This can also be set with `HUGO_CONFIGDIR` OS environment variable.

If the `configDir` exists, the configuration files will be read and merged on top of each other from left to right; the right-most value will win on duplicates.

Given the example tree below:

If `environment` is `production`, the left-most `config.toml` would be the one directly below the project (this can now be omitted if you want), and then `_default/config.toml` and finally `production/config.toml`. And since these will be merged, you can just provide the environment specific configuration setting in you production config, e.g. `enableGitInfo = true`. The order within the directories will be lexical (`config.toml` and then `params.toml`).

```bash
config
├── _default
│   ├── config.toml
│   ├── languages.toml
│   ├── menus
│   │   ├── menus.en.toml
│   │   └── menus.zh.toml
│   └── params.toml
├── development
│   └── params.toml
└── production
    ├── config.toml
    └── params.toml
```

Some configuration maps support the language code in the filename (e.g. `menus.en.toml`): `menus` (`menu` also works) and `params`.

Also note that the only folders with "a meaning" in the above listing is the top level directories below `config`. The `menus` sub folder is just added for better organization.

We use `TOML` in the example above, but Hugo also supports `JSON` and `YAML` as configuration formats. These can be mixed.

Fixes #5422

resource/image: Fix "always false" condition

Found using gocritic linter.

tpl: Add reflect namespace

Add a reflect namespace that offers a two boolean functions for
testing if a value is a map or slice.

Fixes #4081

minifiers: Fixx CSS2 color code handling

Fixes #5506

tpl/hugo: Use the correct Hugo var

See #5467

hugolib: Add .Site.Sites

Fixes #5504

Add tpl/site and tpl/hugo

This means that the current `.Site` and ´.Hugo` is available as a globals, so you can do `site.IsServer`, `hugo.Version` etc.

Fixes #5470
Fixes #5467
Fixes #5503

cache/filecache: Simplify test

See #5497

cache/filecache: Use OS fs for test

See #5497

tpl: Add godoc packages comments

Also fix package name in tpl/templates.

common/collections: Fix defines typo

releaser: Prepare repository for 0.53-DEV

[ci skip]

releaser: Add release notes to /docs for release of 0.52

[ci skip]

releaser: Bump versions for release of 0.52

[ci skip]

Release 0.52

releaser: Add release notes draft for 0.52

Rename to *-ready.md to continue. [ci skip]

hugolib: Fall back to title in ByLinkTitle sort

Fixes #4953

hugolib: Improve nil handling in IsDescendant and IsAncestor

Fixes #5461

parser/pageparser: Fix handling of commented out front matter

When the page parser was rewritten in 0.51, this was interpreted literally, but commented out front matter is used in the wild to "hide it from GitHub", e.g:

```
<!--
+++
title = "hello"
+++
-->
```

Fixes #5478

Remove duplicate mapstructure depdendency

Add dependency list to README

tpl/path: Add tests

tpl: Regenerate templates

tpl: Fix whitespace issue

 Introduced  in #5276.

tpl: Add "param" shortcode

Fixes #4010

docs: Document inline shortcodes

See #4011

Add inline shortcode support

An inline shortcode's name must end with `.inline`, all lowercase.

E.g.:

```bash
{{< time.inline >}}{{ now }}{{< /time.inline >}}
```

The above will print the current date and time.

Note that an inline shortcode's inner content is parsed and executed as a Go text template with the same context as a regular shortcode template.

This means that the current page can be accessed via `.Page.Title` etc. This also means that there are no concept of "nested inline shortcodes".

The same inline shortcode can be reused later in the same content file, with different params if needed, using the self-closing syntax:

```
{{< time.inline />}}
```

Fixes #4011

tpl/collections: Add float64 support to where

Fixes #5466

parser/pageparser: Fix when only shortcode and then summary

Fixes #5464

commands: Include drafts in convert command

Fixes #5457

Handle themes in the new file cache (for images, assets)

In the newly consolidated file cache implementation, we forgot that we also look in the theme(s) for assets (SCSS transformations etc.), which is not good for Netlify and the demo sites.

Fixes #5460

Fix ignored --config flag with 'new' command

Fix Permalink for resource, baseURL with path and canonifyURLs set

Fixes #5226

Add tests for permalink on Resource with baseURL with path

See #5226

helpers: Add a comment about file mode for new files

See #5434

cache/filecache: Add a :project placeholder

This allows for "cache per Hugo project", making `hugo --gc` work as expected, even if you have several Hugo projects running on the same PC.

See #5439

cache/filecache: Add a cache prune func

Fixes #5439

cache/filecache: Add a filecache root dir

This is just a safe guard to make sure we don't evict/remove files that do not belong to the cache.

cache/filecache: Use time.Duration for maxAge

Fixes #5438

cache/filecache: Split implementation and config into separate files

Update to LibSASS 3.5.5

Fixes #5432
See #5435