Merge commit 'd6a4af7018e8618944a6471ceeb7aae1d4df6afa'

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

37095d540 Fix shortcode example

git-subtree-dir: docs
git-subtree-split: 37095d5403cb96f1dc5288d9554e270367f5c449

Merge commit '74309fe5699a595080fdb3a14711e0869babce99'

Squashed 'docs/' changes from e5e98b950..084804447

084804447 Update shortcode-templates.md
c01b02434 Correct misspelling of 'default'
52a831cca Added missing parenthesis
59e8e660a Fix spelling typos
29ad53c9c Yes, HTML is a valid content format
c6b193c6f Update shortcode-templates.md
1f2846e6d Fix typo in output format README
5882f7a4c Fix typo
a90a00bb0 Update multilingual.md
62bf0f184 Documentation for Open Graph & Twitter Cards
f4d624da3 Document "images", "videos", etc. in front-matter
6a85b5df1 Document anchorize and Resources.Content
04c8a5b0e Fix minor typo in 0.49.2 release note
dbe77e948 Release 0.49.2
ea6c9658e Merge branch 'temp492'
85c45b725 Merge branch 'release-0.49.2'
7ad1fba29 releaser: Prepare repository for 0.50-DEV
b25bcc3f2 releaser: Add release notes to /docs for release of 0.49.2
78b751b91 releaser: Bump versions for release of 0.49.2
e3f09762c Release 0.49.1
bd5b94558 Merge branch 'temp491'
0007e0661 Merge branch 'release-0.49.1'
74d2f3a6f releaser: Prepare repository for 0.50-DEV
bbee7e9d3 releaser: Add release notes to /docs for release of 0.49.1
ae40c89c7 releaser: Bump versions for release of 0.49.1
11079fb48 Add draft statement to FAQ
069b9472f Addin Hokus CMS to frontends list.
6e8850670 Add MediaType docs
f3ca6209a Add `languageName` to configuration
fd1cde5ea tpl: Add a delimiter parameter to lang.NumFmt
c620ff78a Update doc to use proper variable
7317c339a add tools->hugo-elasticsearch description to docs
d758ef94a hugolib: Introduce Page.NextPage and Page.PrevPage
9c93ac031 Update installing.md
7c0b5b7f5 Use ISO 639-1 code for examples
9a9e40ba8 Fix spelling
9a6216c18 Hugo 0.49
55aa91185 Merge branch 'temp49'
e0a36421e releaser: Prepare repository for 0.50-DEV
c07b3b385 releaser: Add release notes to /docs for release of 0.49
c1175a12a releaser: Bump versions for release of 0.49
2966f6254 docs: Document directory based archetypes
73dcd02ed Add showcase archetype folder
0a55ad11b docs: Regenerate CLI docs
e09866c2d docs: Document group
ef986358a Merge commit '807c551922707fc5ae0eb26e8f01638c0c63fdb3'
681f14fc9 tpl/collections: Allow first function to return an empty slice
f6dcc93bc docs: Add docs for append
aae528ca3 Merge commit '13e64d72763bf8d6d92d4cdfc15ed45ee9debfab'
02b62294c tpl/strings: Add strings.FirstUpper
bf3e61ba3 hugolib: Do not FirstUpper taxonomy titles

git-subtree-dir: docs
git-subtree-split: 084804447402ab99b51bf49f0da809bee8c16339

common/loggers: Make sure the global logger also gets colored labels

See #4414

i18n: Avoid using the global logger

See #4414

common/loggers: Add color to ERROR and WARN

Fixes #4414

common/herrors: Make the file error log format configurable

Will check for an OS environment variable named `HUGO_FILE_LOG_FORMAT`.

The tokens available are `:file` (absolute filename), `:line` (line number) and `:col` (column number).

The default format is: \":file::line::col\"`

How to set OS environment variables is OS specific, but an example on Unix setting an alternative format when running Hugo:

```bash
env HUGO_FILE_LOG_FORMAT="\":file::line\"" hugo
```

The above will include filename and line number quoted.

Fixes #5352

common/collections: Allow a mix of slice types in append/Scratch.Add

The type handling in these was improved in Hugo 0.49, but this also meant that it was no longer possible to start out with a string slice and later append `Page` etc. to it.

This commit makes sure that the old behaviour is now possible again by falling back to a `[]interface{}` as a last resort.

Fixes #5361

resource: Allow .Data.Integrity to be accessed on its own

Fixes #5296

Revert "mod: Update minify"

This reverts commit 83c873ff37ddd379181540021232f026e7678486.

mod: Update minify

Closes #5261

mod: Update cast

Closes #5340

commands: Truncate the error log on repeated config errors

docs: Regenerate CLI docs

Closes #5354

resource: Serialize image processing

Fixes #5220

commands: Only show Ansi escape codes if in a terminal

Fix archetype handling of directories in theme

Fixes #5318

Revert "commands: Read disableFastRender from flag even if it's not changed"

On second thought, removing this isn't worth it.

This reverts commit 78a4c2e32ef9ea8e92bb7bb3586e4c22b02eb494.

commands: Read disableFastRender from flag even if it's not changed

Fixes #5353

comamnds: Use overflow-x: auto; for browser errors

common/loggers: Remove the ANSI color for the browser error version

hugolib: Adjust error test to make it pass on Go tip

tpl: Handle truncated identifiers in Go template errors

Long identifiers will give errors on the format:

```bash
 _default/single.html:5:14: executing "main" at <.ThisIsAVeryLongTitl...>: can't evaluate field ThisIsAVeryLongTitle
```

Hugo use this value to match the "base template or not", so we need to strip the "...".

Fixes #5346

Add some color to the relevant filenames in terminal log

Fixes #5344

Run gofmt -s

hugolib: Rename some page_* files

To make it easier to see/work with the source files that is about the `Page` struct.

Resolve error handling/parser related TODOs

See #5324

herrors: Improve handling of JSON errors

`*json.UnmarshalTypeError` and `*json.SyntaxError` has a byte `Offset`, so use that.

This commit also reworks/simplifies the errror line matching logic. This also makes the file reading unbuffered, but that should be fine in this error case.

See #5324

commands, hugolib: Get file context in "config parse failed" errors

Fixes #5325

hugolib: Improve errors in /i18n handlling

See #5324

hugolib: Improve errors in /data handlling

See #5324

hugolib: Continue the file context/line number errors work

See #5324

hugolib: Remove the now superflous Source struct

See #5324

Convert the rest to new page parser code paths

And remove some now unused code.

See #5324

parser/metadecoders: Consolidate the metadata decoders

See #5324

hugolib: Redo the summary delimiter logic

Now that we have a proper page parse tree, this can be greatly simplified.

See #5324

hugolib: Integrate new page parser

See #5324

hugolib: Use []byte in shortcode parsing

See #5324

parser/pageparser: Use []byte in page lexer

See #5324

parser/pageparser: Add front matter etc. support

See #5324

parser/pageparser: File renames and splitting

See #5324

Move the shortcode parser to the new pageparser package

See #5324

commands: Avoid panic in error handler on config errors

tpl: Update Jsonify to return pretty-print output

Fixes #5040

Prevent stale content in Fast Render Mode

We do that by re-render visited pages that is not already in the stack. This may potentially do some double work, but that small penalty should be well worth it.

Fixes #5281

hugolib: Fix test on Windows

tpl: Improve the Execute panic error message

See #5327

Allow date and slug from filename for leaf bundles

Fixes #4558

commands: Show server error info in browser

The main item in this commit is showing of errors with a file context when running `hugo server`.

This can be turned off: `hugo server --disableBrowserError` (can also be set in `config.toml`).

But to get there, the error handling in Hugo needed a revision. There are some items left TODO for commits soon to follow, most notable errors in content and config files.

Fixes #5284
Fixes #5290
See #5325
See #5324

Simple doc fix in CONTRIBUTING.md

tpl: Use .Lastmod in embedded schema template

Fixes #5320

Revert "commands: Add .gitignore "hugo new site""

This fails on Windows, so it needs to be reconsidered.

This reverts commit 92979d92889ff8991acfadd42982c2e55d01b163.

commands: Add .gitignore "hugo new site"

resource: Optimize integrity string generation

Remove use of fmt.Sprintf for simple string concatenation.  A simple
change for a small perf boost.

```
name         old time/op    new time/op    delta
Integrity-4     525ns ± 2%     268ns ± 2%  -48.92%  (p=0.000 n=10+10)

name         old alloc/op   new alloc/op   delta
Integrity-4      144B ± 0%      112B ± 0%  -22.22%  (p=0.000 n=10+10)

name         old allocs/op  new allocs/op  delta
Integrity-4      5.00 ± 0%      3.00 ± 0%  -40.00%  (p=0.000 n=10+10)
```

commands: Add help text to "hugo new"

snap: Set "extended" tag based on build_url on Launchpad

Read build_url from $SNAPCRAFT_IMAGE_INFO to determine whether
to add the "extended" build tag or not.  This allows us to do away
with the extended-snap-master and extended-snap-stable branches.

helpers: Call rst2html directly on *nix

Initially, rst2html was called via the python interpreter which would
fail if the script was wrapped in a launcher as on NixOS.
Ideally, on *nix, binaries should be invoked directly to ensure that
shebangs work properly as is being done now.
Handle the case of windows as it doesn't do shebangs.

Update URLs to stop 301 redirects

Merge branch 'release-0.49.2'

releaser: Prepare repository for 0.50-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.49.2

[ci skip]

Release 0.49.2

releaser: Add release notes draft for 0.49.2

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

common/collections: Fix type checking in Append

The fix introduced in Hugo `0.49.1` had an unintended side-effect in the `Append` func used in both `append` and `.Scratch.Add`.

This commit fixes that by loosen/fixing the type checking so concrete types can be appended to interface slices.

Fixes #5303

common/collections: Fix type checking in Append

The fix introduced in Hugo `0.49.1` had an unintended side-effect in the `Append` func used in both `append` and `.Scratch.Add`.

This commit fixes that by loosen/fixing the type checking so concrete types can be appended to interface slices.

Fixes #5303

Merge branch 'release-0.49.1'

releaser: Prepare repository for 0.50-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.49.1

[ci skip]

Relase 0.49.1

releaser: Add release notes draft for 0.49.1

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

common/maps: Improve append in Scratch

This commit consolidates the reflective collections handling in `.Scratch` vs the `tpl` package so they use the same code paths.

This commit also adds support for a corner case where a typed slice is appended to a nil or empty `[]interface{}`.

Fixes #5275

tpl/collections: Fix handling of different interface types in Slice

In Hugo `0.49` we improved type support in `slice`. This has an unfortunate side effect in that `resources.Concat` now expects something that can resolve to `resource.Resources`.

This worked for most situations, but when you try to `slice` different `Resource` objects, you would be getting `[]interface {}` and not `resource.Resources`. And `concat` would fail:

```bash
error calling Concat: slice []interface {} not supported in concat.
```

This commit fixes that by simplifying the type checking logic in `Slice`:

* If the first item implements the `Slicer` interface, we try that
* If the above fails or the first item does not implement `Slicer`, we just return the `[]interface {}`

Fixes #5269

Add GOPATH Hugo building tip

common/maps: Improve append in Scratch

This commit consolidates the reflective collections handling in `.Scratch` vs the `tpl` package so they use the same code paths.

This commit also adds support for a corner case where a typed slice is appended to a nil or empty `[]interface{}`.

Fixes #5275

Revert "tpl: Fix baseof.html in error message"

I need to rethink this.

This reverts commit 646a52a5c5f52890f2d0270b68ba0f863047484a.

tpl: Fix baseof.html in error message

This fix should also make the template loadin slightly faster, as we avoid to reparse the baseof.html files more than one time.

Fixes #5288

helpers: Consolidate MakeSegment vs MakePathSanitized

In short:

* Avoid double tolower in MakeSegment
* Use MakePathSanitized for taxonomies in pageToPermalinkTitle; this matches what MakeSegment does.
* Move the "double hyphen and space" logic into UnicodeSanitize

The last bullet may be slightly breaking for some that now does not get the "--" in some URLs, but we need to reduce the amount of URL logic.

See #4926

hugolib: Use stdlib context package

hugolib: Normalize permalink path segments

When constructing permalinks, ensure that most inputs used as path
segments are normalized with PathSpec.MakeSegment instead of
PathSpec.URLize.

The primary exception to that rule is with taxonomy titles in
pageToPermalinkTitle(). The approach taken here is to use URLize for
taxonomy pages. Everything else will use MakeSegment. The reason for
this exception is that people use taxonomies such as "s1/p1" to generate
URLs precisely they way they wish (see #5223). Tests have been added to
check for this case.

Fixes #4926

hugolib: Fix FuzzyWordCount test error message

Render Markdown in figure shortcode "caption" and "attr" params

Fixes https://github.com/gohugoio/hugo/issues/4406.

Re-organize the figure shortcode for better readability

Update README & CONTRIBUTING

Fix broken links for Dev Chat that point to broken gitter.im room.
Remove lines about `mage vendor` target that is no longer available.
Remove broken table of contents links for headings in CONTRIBUTING.md
Fix typo

tpl: Cast IsSet key to int for indexed types

Don't assume that the user sends an int as the key when checking against
indexed types.

Fixes #3681

hugolib: Improve error message for bad taxonomy weights

Error is now "Unable to convert taxonomy weight []string{"40"} to int
for variables/files.md"

hugolib: Cast taxonomy weight parameters to int

Fixes #4628

hugolib: Allow nil to be unwrapped as *Page

Previously, calls to *Page.Eq(nil) would always return false because the
unwrapPage func didn't support the nil case.  Add support for unwrapping
nil to a *Page.

Fixes #5043

tpl/collections: Fix handling of different interface types in Slice

In Hugo `0.49` we improved type support in `slice`. This has an unfortunate side effect in that `resources.Concat` now expects something that can resolve to `resource.Resources`.

This worked for most situations, but when you try to `slice` different `Resource` objects, you would be getting `[]interface {}` and not `resource.Resources`. And `concat` would fail:

```bash
error calling Concat: slice []interface {} not supported in concat.
```

This commit fixes that by simplifying the type checking logic in `Slice`:

* If the first item implements the `Slicer` interface, we try that
* If the above fails or the first item does not implement `Slicer`, we just return the `[]interface {}`

Fixes #5269

tpl: Add a delimiter parameter to lang.NumFmt

The original implementation of NumFmt did not take into account that the
options delimiter (a space) could be a valid option.  Adding a delim
parameter seems like the simplest, safest, and most flexible way to
solve this oversight in a backwards-compatible way.

Fixes #5260

snap: Add custom x-nodejs plugin to support ppc64el and s390x

snap: Fetch mage with GO111MODULE=off

snap: Revert 'Skip "mage -v test" due to build failure on Launchpad'

This reverts commit 52ac85fbc4d4066b5e13df454593597df0166262.

snap: Use build-snaps instead of building go from source

See https://forum.snapcraft.io/t/go-part-fails-with-go1-11-if-go-mod-exists-in-the-top-level-directory/7546/11

hugolib: Be a litle more specific in NextPage TODO

hugolib: Introduce Page.NextPage and Page.PrevPage

Introduce new page position variables in order to fix the ordering issue
of `.Next` and `.Prev` while also allowing an upgrade path via
deprecation.

`.NextInSection` becomes `.NextPageInSection`.
`.PrevInSection` becomes `.PrevPageInSection`.

`.Next` becomes a function returning `.PrevPage`.
`.Prev` becomes a function returning `.NextPage`.

Fixes #1061

snap: Skip "mage -v test" due to build failure on Launchpad

The run "go test ./... -tags none" fails with multiple errors of

    use of internal package github.com/gohugoio/hugo/tpl/internal not allowed

See https://launchpadlibrarian.net/390252700/buildlog_snap_ubuntu_xenial_amd64_hugo-dev_BUILDING.txt.gz

I was unable to reproduce it with snapcraft in LXD
on my local Debian laptop, so this error is still a mystery to me.

releaser: Update path to snap/snapcraft.yaml