output: Add some more layout docshelper variants

hugolib: Add validation for defaultContentLanguage

When `languages` are defined, then `defaultContentLanguage` must match one of those.

Fixes #4298

releaser: Prepare repository for 0.34-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.33

[ci skip]

Release 0.33

releaser: Add release notes draft for 0.33

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

output: Redo the docshelper layouts examples

Merge commit '3cf4300097610bb8b5bd0686d96d1df5db641895'

Squashed 'docs/' changes from ddb7d8fae..56c34962c

56c34962c Fix multilingual config examples
14fa0b4ed Release 0.32.4
18779d54a releaser: Add release notes to /docs for release of 0.32.4
0d47d0673 releaser: Bump versions for release of 0.32.4
424acf02e Release 0.32.3
f6f04e084 releaser: Prepare repository for 0.33-DEV
1a9b36286 releaser: Add release notes to /docs for release of 0.32.3
9284c3284 releaser: Bump versions for release of 0.32.3
796082289 Fix min Go version in installing
74625a654 Add alias to multilingual.md
bf65732b4 Add some new tweets to the front page
7f263353e Bump Netlify to 0.32.2
cbb3a4f1c Update 0.32.2 release notes
e90ae4b4e releaser: Prepare repository for 0.33-DEV
ee74a8f4f releaser: Add release notes to /docs for release of 0.32.2
d889c4fa4 releaser: Bump versions for release of 0.32.2
4a46d3aca Merge commit 'eb738cd35cca1ffc68c5ed688dbe2a19108e8761'
b98d95ff2 releaser: Prepare repository for 0.33-DEV

git-subtree-dir: docs
git-subtree-split: 56c34962c92706792231fd5056d33186b11c4e33

Improve .Site.GetPage for regular translated pages

You can still use the full path with extensions, but to get the current language version:

* If the content file lives in `/content/blog/mypost.en.md`
* Use `.Site.GetPage "page" "blog/mypost"`

Fixes #4285

resource: Use path.Match instead of filepath.Match

They behave similar, but it is a path we're matching.

See #4244

resource: Add front matter metadata to Resource

This commit expands the Resource interface with 3 new methods:

* Name
* Title
* Params

All of these can be set in the Page front matter. `Name` will get its default value from the base filename, and is the value used in the ByPrefix and GetByPrefix lookup methods.

Fixes #4244

Update Afero to avoid panic on "file name is too long"

Fixes #4240

resource: Fix handling of very long image file names

Fixes #4261

commands: And now really fix the server watch logic

See #4275

commands: Fix server without watch

This was broken in Hugo 0.30.

Fixes #4275

Update Chroma and other third-party deps

Fixes #4267

commands: Remove superflous BuildDate logic

Fixes #4272

layout: Respect Type and Layout for list template selection

This commit also has some other nice side-effects:

* The layout logic is unified for all page types, which should make it less surprising
* Page.Render now supports all types
* The legacy "indexes" type is removed from the template lookup order. This is an undocumented type from early Hugo days. This means that having a template in, say, `/layouts/indexes/list.html` will no longer work.
* The theme override logic is improved. As an example, an `index.html` in theme will now wn over a `_default/list.html` in the project, which most will expect.

Fixes #3005
Fixes #3245

Run benchmarks 3 times

resource: Add some GoDoc

hugolib: Allow url in front matter for list type pages

This enables some potential foot-shooting, but is needed for some special URL requirements.

Fixes #4263

resource: Implement Resources.ByPrefix

Fixes #4266

resource: Make GetByPrefix work for Page resources

Fixes #4264

Support uglyURLs per section

Fixes #4256

resource: Make .Resources.GetByPrefix case insensitive

Fixes #4258

Update CONTRIBUTING.md

Support offline builds

releaser: Prepare repository for 0.33-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.32.4

[ci skip]

Release 0.32.4

releaser: Add release notes draft for 0.32.4

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

releaser: Git info bounds checking

resource: Remove superflous comment

Correct fix for --cleanDestinationDir flag

Fixes #4246
Fixes #4248

Revert "Remove the --cleanDestinationDir flag", there is a better fix.

This reverts commit 768ec5df9fa8f91610ee80a9e6194f94a7dbe117.

Fix non-ASCII path handling for Page resources

Fixes #4241

Remove the --cleanDestinationDir flag

This is no longer supported. Since Hugo 0.32 we do static sync and build in parallel.

Closes #4246

releaser: Prepare repository for 0.33-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.32.3

[ci skip]

Release 0.32.2

releaser: Add release notes draft for 0.32.3

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

hugolib: Fix handling of mixed-case taxonomy folders with content file

* We match by path vs taxonomy to determine if we have a content page for that taxonomy
* The taxonomy name is (if `preserveTaxonomyNames` is not set) normalized to `maxmustermann` while you have the disk folder called `MaxMustermann`.
* This isn't a new issue, but I suspect most people will just name the folder `authors/maxmustermann` and it will just work.
* The inconsistent behaviour you see here is that you will end up with two pages with the same target filename, so it is a little random who will win.

This fixes that by also normalizing the taxonomy path when doing the comparison.

Fixes #4238

resource: Avoid processing and storing same image for each language

Fixes #4231

resource: Resources.ByType should return Resources

Currently it returns []Resource.

This way the invocations can be nested.

Fixes #4234

Fix multihost detection for sites without language definition

Static content was wrongly put into the lang-code subfolder.

Fixes #4221

commands: Report build time on config.toml change

Fixes #4232
See #4224

Fix hugo benchmark --renderToMemory

Fixes #4218

Fix URLs for bundle resources in multihost mode

Fixes #4217

Fix sub-folder baseURL handling for Page resources

I.e. images etc.

Fixes #4228

releaser: Prepare repository for 0.33-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.32.2

[ci skip]

Release 0.32.2

releaser: Add release notes draft for 0.32.2

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

resource: Handle publish to /public on fresh build

Fixes #4213

Merge commit 'eb738cd35cca1ffc68c5ed688dbe2a19108e8761'

Squashed 'docs/' changes from fc61378a3..ddb7d8fae

ddb7d8fae Fix spelling in error message
84f7e09ff Add an "sharing image" to the 0.32 doc
a6d39884c Add image processing examples
717e25400 Release 0.32.1
07a4fc1c1 Merge branch 'temp321'
401ed894b releaser: Add release notes to /docs for release of 0.32.1
aa040d965 releaser: Bump versions for release of 0.32.1
6d22558ec Close shortcode
442afa7f5 Add a link to the 0.32 HOWTO with a searchable title
9a9a7e475 Add a note about the shortcode issue
76d731ce2 Add title etc. to release notes
eac596de8 Release v0.32
ede3e25dc Merge branch 'tmp32'
c92f1701b releaser: Prepare repository for 0.33-DEV
e498e97f9 releaser: Add release notes to /docs for release of 0.32
1d476fc59 Fix typo
9bac78a2f Merge commit 'f3cd083961f36dc96d05e98aaf67f650102bc757'
7d8c78391 Add Pandoc support, refactor external helpers

git-subtree-dir: docs
git-subtree-split: ddb7d8fae07ee8813652d20829d606dd6637f0a9

releaser: Prepare repository for 0.33-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.32.1

[ci skip]

Release Hugo 0.32.1

releaser: Add release notes draft for 0.32.1

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

commands: Fix broken hugo --renderToMemory

The `--renderToMemory` flag stopped working on `hugo` in 0.32.

Note that this is only useful for benchmark testing, as there is no easy way to actually view the result.

Fixes #4212

resource: Use the correct Destination FS

Source and destination will be the same when this happens, but it should be correct.

See #4202

resource: Create target dir if not exists

This is the case where image processing is triggered from shortcodes, i.e. before the target page's folder in /public is created.

Fixes #4202

hugolib: Add test for image processing from shortcodes

See #4202

releaser: Prepare repository for 0.33-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.32

[ci skip]

Release v0.32

releaser: Add release notes draft for 0.32

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

Merge commit 'f3cd083961f36dc96d05e98aaf67f650102bc757'

Squashed 'docs/' changes from 3e663efb2..fc61378a3

fc61378a3 Add Hugo 0.32 related docs
77edf7fd7 commands: Regenerate
af9d25458 Fix Blackfriday's Markdown extension name
1223dd63a Remove roadmap
b8bcb2fb8 Include note to allow hugo write permissions outside home dir
7dbccb936 Fix typo in roadmap
3a38da6f5 Fix spelling
94ebe50ff Merge branch 'master' of github.com:gohugoio/hugoDocs
89376e21d Clarify Hugo Roadmap
03d191fec Mention Reverse function in taxonomy tpl page.
a4ea3402d Fix ref and relref function pages.
b36632b31 Remove non-existing source variable
a638160dc Update Content Organization to match the world
47eb431ca Correct one link in templates/output-formats.md
8bf933629 Spell fix
ce2d48728 Add docs for .AllTranslations
de94b4942 Move sponsor data to theme data
41fe75254 Merge commit 'f463ef99ed2862e4042557e28aece7ca858e1d0a'
f463ef99e Squashed 'themes/gohugoioTheme/' changes from bc851da9..75da2f6b
532c65f2a Move sponsor logo to theme
899e2defe Add sponsor logos to home page and footer
3ca53db97 Release 0.31.1
bb9876ce2 Merge branch 'temp0311'
c7c3ee7e5 releaser: Prepare repository for 0.32-DEV
4ac554792 releaser: Add release notes to /docs for release of 0.31.1
52bfb5c15 releaser: Bump versions for release of 0.31.1
cfdc2e4ea Fix output formats example
5746c10c2 More on output format
de2ee0fe0 Improve suffix redefinition example
c9997839e Update gitlab CI submodule management
82d74e306 Add Bootstrap styling to breadcrumb example
c8c9601a8 Use the code shortcode for the breadcrumb example
16be43e7d Clean up formatting in variable definition lists
149c2c157 Add nested section docs
783c3d636 Sync theme
60a220bbd Squashed 'themes/gohugoioTheme/' changes from 6b632895..bc851da9
4b33a04d0 Fix typo
94cffc43c Fix little typo
a5d4f762f Fix typo
36c5a0b43 Add a note about the 2 in staticDir2
087bd9a9f Add KeyCDN to menu
4ac8aae38 Hugo 0.31 Released
8fdd995e7 releaser: Prepare repository for 0.32-DEV
eb0f38fbb releaser: Add release notes to /docs for release of 0.31
60efdfff7 releaser: Bump versions for release of 0.31
44dafb10b Merge commit '30c0d485eaff6d70df1be0353911ddca485d52bf'
e6b847b95 Merge commit '05e42bc643f1840ed2ad9c2eff82a269d1381683'
15d86a525 Handle Taxonomy permalinks
5c3c18d7f Add support for height argument to figure shortcode

git-subtree-dir: docs
git-subtree-split: fc61378a3227c14883a2942d67c806014e7bb6cb

hugolib: Add test for homepage content for all rendering engines

Update #4166

tpl/transform: Do not unescape input to highlight

Fixes #4179

commands: Make sure all language homes are always re-rendered in fast render mode

Fixes #4125

hugolib: Do not tolower result from Page.GetParam

We still do lowering of the param strings in some internal use of this, but the exported `GetParam` method is changed to a more sensible default.

This was used for the `disqus_title` etc. in the internal Disqus template, which was obviously not right.

If you really want to lowercase your params, do it with `.GetParam "myparam" | lower` or similar.

Fixes #4187

resource: Avoid potential case issue in image names

helpers: Avoid writing the last MD5 buff part twice

resource: Use MD5 to identify image files

But only a set of byte chunks spread around in the image file to calculate the fingerprint, which is much faster than reading the whole file:

```bash
BenchmarkMD5FromFileFast/full=false-4            300000       4356 ns/op      240 B/op        5 allocs/op
BenchmarkMD5FromFileFast/full=true-4              30000      42899 ns/op    32944 B/op        5 allocs/op
```

Fixes #4186

source: Fix test on Windows

source: Make sure .File.Dir() ends with a slash

Updates #4190

:sparkles: Implement Page bundling and image handling

This commit is not the smallest in Hugo's history.

Some hightlights include:

* Page bundles (for complete articles, keeping images and content together etc.).
* Bundled images can be processed in as many versions/sizes as you need with the three methods `Resize`, `Fill` and `Fit`.
* Processed images are cached inside `resources/_gen/images` (default) in your project.
* Symbolic links (both files and dirs) are now allowed anywhere inside /content
* A new table based build summary
* The "Total in nn ms" now reports the total including the handling of the files inside /static. So if it now reports more than you're used to, it is just **more real** and probably faster than before (see below).

A site building  benchmark run compared to `v0.31.1` shows that this should be slightly faster and use less memory:

```bash
▶ ./benchSite.sh "TOML,num_langs=.*,num_root_sections=5,num_pages=(500|1000),tags_per_page=5,shortcodes,render"

benchmark                                                                                                         old ns/op     new ns/op     delta
BenchmarkSiteBuilding/TOML,num_langs=1,num_root_sections=5,num_pages=500,tags_per_page=5,shortcodes,render-4      101785785     78067944      -23.30%
BenchmarkSiteBuilding/TOML,num_langs=1,num_root_sections=5,num_pages=1000,tags_per_page=5,shortcodes,render-4     185481057     149159919     -19.58%
BenchmarkSiteBuilding/TOML,num_langs=3,num_root_sections=5,num_pages=500,tags_per_page=5,shortcodes,render-4      103149918     85679409      -16.94%
BenchmarkSiteBuilding/TOML,num_langs=3,num_root_sections=5,num_pages=1000,tags_per_page=5,shortcodes,render-4     203515478     169208775     -16.86%

benchmark                                                                                                         old allocs     new allocs     delta
BenchmarkSiteBuilding/TOML,num_langs=1,num_root_sections=5,num_pages=500,tags_per_page=5,shortcodes,render-4      532464         391539         -26.47%
BenchmarkSiteBuilding/TOML,num_langs=1,num_root_sections=5,num_pages=1000,tags_per_page=5,shortcodes,render-4     1056549        772702         -26.87%
BenchmarkSiteBuilding/TOML,num_langs=3,num_root_sections=5,num_pages=500,tags_per_page=5,shortcodes,render-4      555974         406630         -26.86%
BenchmarkSiteBuilding/TOML,num_langs=3,num_root_sections=5,num_pages=1000,tags_per_page=5,shortcodes,render-4     1086545        789922         -27.30%

benchmark                                                                                                         old bytes     new bytes     delta
BenchmarkSiteBuilding/TOML,num_langs=1,num_root_sections=5,num_pages=500,tags_per_page=5,shortcodes,render-4      53243246      43598155      -18.12%
BenchmarkSiteBuilding/TOML,num_langs=1,num_root_sections=5,num_pages=1000,tags_per_page=5,shortcodes,render-4     105811617     86087116      -18.64%
BenchmarkSiteBuilding/TOML,num_langs=3,num_root_sections=5,num_pages=500,tags_per_page=5,shortcodes,render-4      54558852      44545097      -18.35%
BenchmarkSiteBuilding/TOML,num_langs=3,num_root_sections=5,num_pages=1000,tags_per_page=5,shortcodes,render-4     106903858     86978413      -18.64%
```

Fixes #3651
Closes #3158
Fixes #1014
Closes #2021
Fixes #1240
Updates #3757

tpl/strings: Fix broken test

Make chomp return the type it receives

fixes #2187

Reuse the BlackFriday instance when possible

This is in heavy use in rendering, so this makes a difference:

```bash
benchmark                                                                                    old ns/op     new ns/op     delta
BenchmarkSiteBuilding/TOML,num_langs=1,num_pages=500,tags_per_page=5,shortcodes,render-4     124551144     107743429     -13.49%

benchmark                                                                                    old allocs     new allocs     delta
BenchmarkSiteBuilding/TOML,num_langs=1,num_pages=500,tags_per_page=5,shortcodes,render-4     528684         435118         -17.70%

benchmark                                                                                    old bytes     new bytes     delta
BenchmarkSiteBuilding/TOML,num_langs=1,num_pages=500,tags_per_page=5,shortcodes,render-4     53306848      45147832      -15.31%
```

livereload: Fix host comparison when ports aren't present

Compare the original hosts from 'Origin' and 'Host' headers before
attempting to do a port-less comparison.  This helps in the case when
hugo server was started with a '--port=80' so both headers do not
contain a port.

Fixes #4141

Add .Title and .Page to MenuEntry

It uses `title` if configured on the menu entry. If not, it uses the `Page.Title` when possible.

Fixes #2784

Remove the goroutines from the shortcode lexer

It was clever, but storing the items in a slice is faster -- and it gives room to more goroutines in other places.

```bash
benchmark                     old ns/op     new ns/op     delta
BenchmarkShortcodeLexer-4     180173        79614         -55.81%

benchmark                     old allocs     new allocs     delta
BenchmarkShortcodeLexer-4     309            328            +6.15%

benchmark                     old bytes     new bytes     delta
BenchmarkShortcodeLexer-4     35456         47008         +32.58%
```

mage: Do not run Go Fmt check on Go tip

Adjust the stale setup

Add Github stale bot config

Use StopTimer in site benchmarks

Add output formats definition to benchmarks

Improve site benchmarks

Fix context of opengraph video range

Fixes #4136