Merge tag 'v0.41'

releaser: 0.41 [ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.41

[ci skip]

Release 0.41

releaser: Add release notes draft for 0.41

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

releaser: Put release notes below /en

Fixes #4712

create: Provide the correct .Site object to archetype templates

Fixes #4732

docs: Document the GDPR Privacy Config

See #4751

Fix GA anonymizeIp order

Add no-cookie variants of the Google Analytics templates

The current full set of options for GA is now:

```toml
[privacy]
[privacy.googleAnalytics]
disable = false
respectDoNotTrack = true
anonymizeIP = true
useSessionStorage = true
```

Fixes #4775

Merge commit 'd2b1030060d3c91d5f9ffa3456418da16bd74f1d'

Squashed 'docs/' changes from e161ea09d..0fd7b4169

0fd7b4169 Fix typo: pygmentsUseClasses -> pygmentsUseClassic
9a3e1c19a Clarify that lower weight gets higher precedence
820d8b581 Clarify the true behavior of hrefTargetBlank #blackfriday
eb3aa5e46 Fix typo
9aedb9269 Add examples for removing default taxonomies
772a26f84 Fix source link on maintainance
975c215ae Minor edits.
2bdb1a150 Fix invalid iink
991d2e139 Fix misspelling
60af8dfb0 Update eSolia link
d7426b76e Release 0.40.3
4977bd9cf Merge branch 'release-0.40.3'
9946f7108 releaser: Prepare repository for 0.41-DEV
beef16b01 releaser: Add release notes to /docs for release of 0.40.3
80c51c55a releaser: Bump versions for release of 0.40.3
21e2934c5 rename `taxonomies.html` to `taxonomy.html`
34a02c289 Add release notes from Hugo 0.7 to 0.15 for completeness
b593f512e Update related.md
7c2bf528b Fix the "edit this page" link
e8fbc163e Add warning about cond
ae15a8831 Add link to Markdown Guide
e077dfd65 Added documentation for a new migration tool: BlogMl2Hugo
957bfb6a8 Add Talkayrd, a new commenting system, & fix txtpen link
86acea7f8 Tomango showcase
3c2fc32f1 Fix snap classic command in installing.md
9a76f1737 Merge commit '83bef6955e014d40c0f00db9cebe09113154e999'
a4b71fb84 Fix typo

git-subtree-dir: docs
git-subtree-split: 0fd7b416997bf76cd99e3ae2dfae406cb8b6724a

tpl: Remove the shortcode assets for now

Not in use.

tpl: Adjust instagram_simple margins

Remove youtube_simple for now

We need to revisit and complete that.

See #4751

Add anonymizeIP to GA privacy config

See #4751

Fix broken test

Support DNT in Twitter shortcode for GDPR

Fixes #4765

tpl: Alias tweet shortode to twitter

See #4765

Regenerate embedded templates

See #4761

Fix youtube_simple thumb scaling

Fixes #4761

Add instagram_simple shortcode

Fixes #4748

deps: Go fmt

Remove the id from youtube_simple

For now, anyway.

See #4751

Fix some recently broken embedded templates

And add tests for them.

Fixes #4757

Add an unified .Site.Config with a services section

Fixes #4751

Move the privacy config into a parent

See #4751

commands: Avoid ANSI character output on Windows

Fixes #4462

tpl: Add another class and an id to youtube_simple

To provide some more styling options.

See #4616

Make the simple mode YouTube links schemaless

See #4616

Add YouTube shortcode simple mode

Adapted from the work of @onedrawingperday.

See #4616

Do not return error on .Get "class" and vice versa in shortcodes

The current error handling makes parameter checking in shortcodes too verbose for no good reason.

Fixes #4745

Create SUPPORT.md

To help cut down on the number of general questions, it'd be good to add a `SUPPORT.md` to the `.github` folder.

A link to this would then be displayed automatically when a user opens a New Issue (https://github.com/gohugoio/hugo/issues/new).

To see an example of this take a look at: https://github.com/twbs/bootstrap/issues/new

Add PrivacyEnhanced mode for YouTube to the GDPR Policy

See #4616

Add RespectDoNotTrack to GDPR privacy policy for Google Analytics

See #4616

tpl/tplimpl: Adjust GA templates

See #4616

tpl/tplimpl/embedded: Wrap the relevant templates with the privacy policy disable check

See #4616

config: Add the foundation for GDPR privacy configuration

See #4616

Show site build warning in TestPageBundlerSiteRegular

So that a timeout warning does appear if it does happen
especially on a slow machine with soft floating-point CPU.

Special thanks to @bep for the solution.

See #4672

commands: Do not show empty BuildDate in version

hugolib: Use double quotes instead of back quotes

so that '\n' is interpreted in the timeout warning.

Improve markup determination logic

Sets Page.markup earlier (as early as possible, when the page is
loaded). Sets it once and only once, removing many redundant calls
to determineMarkupType().

This kills a sleeping bug that was avoided by the parts of the
code depending on this value making those redundant calls.

Merge branch 'release-0.40.3'

releaser: Prepare repository for 0.41-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.40.3

[ci skip]

Release 0.40.3

releaser: Add release notes draft for 0.40.3

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

hugolib: Fix possible .Content cut

There have been one report of a site with truncated `.Content` after the Hugo `0.40.1` release.

This commit fixes this so that race should not be possible anymore. It also adds a stress test with focus on content rendering and multiple output formats.

Fixes #4706

hugolib: Fix possible .Content cut

There have been one report of a site with truncated `.Content` after the Hugo `0.40.1` release.

This commit fixes this so that race should not be possible anymore. It also adds a stress test with focus on content rendering and multiple output formats.

Fixes #4706

tpl/tplimpl: Move README one level up

tpl/tplimpl: Extract internal templates

Having them in separate files should make maintainance easier.

When adding new or making changes to the templates:

```bash
mage generate
```

This will get the Go code in sync.

Fixes #4457

Merge commit '83bef6955e014d40c0f00db9cebe09113154e999'

Squashed 'docs/' changes from 896bad9f4..e161ea09d

e161ea09d Add one more Chinese file to workaround reflect: Zero(nil)
b595b3a21 Add more Chinese translation
56e4e95d9 Use lang.Merge to "fill in the gaps" for untranslated pages
ef079406c Merge commit '650fac3a4e7d256f4505402ab44cfc3c804b8dea'
650fac3a4 Squashed 'themes/gohugoioTheme/' changes from a1768ebb..f31a3dc8
322eff899 Add Chinese language for menus
d90b886e0 Fix Markdown table syntax in previous commit
737f3dfca Update the leaf bundle vs branch bundle table
09fa1bc4e Clarify that `.Now` is obsolete
879ea3f6a Make release notes somewhat more consistent
0113e2051 Move 0.40.2-relnotes into content/en/news
77578f5bf Move content/ into new contentDir content/en/
4dcf7c709 Fix "reflect: Zero(nil)" error in showcase
63dd25505 Release 0.40.2
2076c0d56 releaser: Prepare repository for 0.41-DEV
070fe565e releaser: Add release notes to /docs for release of 0.40.2
4ce52e913 releaser: Bump versions for release of 0.40.2
41907c487 Fix typos in syntax-highlighting.md
91753ef3d Add missing backtick
b77274301 Remove duplicate release notes (0.27, 0.27.1, 0.35)
6e00da316 Remove obsolete content/release-notes/ directory
00a6d8c02 Change en dash back to `--` in 0.38.2-relnotes
51b32dc00 Update archetypes.md
d0e5c2307 Release 0.40.1
4538a6d5b releaser: Prepare repository for 0.41-DEV
91b391d70 releaser: Add release notes to /docs for release of 0.40.1
e0979d143 releaser: Bump versions for release of 0.40.1
7983967c2 Clean images
fe3fdd77d Polish showcase for Flesland Flis
e6dde3989 Showcase - Flesland Flis AS by Absoluttweb
73aa62290 Revive @spf13's special Hugo font
add67b335 Release Hugo 0.40
c0a26e5a6 Merge branch 'temp40'
beeabaaae releaser: Prepare repository for 0.41-DEV
e67d5e985 releaser: Add release notes to /docs for release of 0.40
6cdd95273 releaser: Bump versions for release of 0.40
bee21fb9b Revive the other Hugo logos too
4f45e8fe1 Fix the link type attribute for RSS in examples
8c67dc89a Fix example in delimit doc
e7f6c00d5 Revive the logo used on the forum
82b0cd26e Merge commit 'a215abf70e018f4bf40d6c09d8bd148d8684b33d'
119c8ca58 Merge commit 'd2ec1a06df8ab6b17ad05cb008d5701b40327d47'
db4683bd2 Improve .Get docs
05260b886 .Get function: fix syntax signature

git-subtree-dir: docs
git-subtree-split: e161ea09d33e3199f4998e4d2e9068d5a850f042

Fix typo

This could either be "check out Hugo's themes" or "check out the Hugo themes". I think the latter reads better.

Update CONTRIBUTING.md

Fix typos, simplify language

releaser: Prepare repository for 0.41-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.40.2

[ci skip]

Release 0.40.2

releaser: Add release notes draft for 0.40.2

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

Reset .Page.Scratch on live-reload

Fixes #4683

Fix .WordCount, .FuzzyWordCount, .ReadingTime when summary marker is set

This bug was introduced in Hugo 0.40. It is when you use the `<!--more-->` summary marker.

Note that this affects the word stats only. The related `PlainWords`, `Plain`, `Content` all return correct values.

Fixes #4675
Fixes #4682

releaser: Prepare repository for 0.41-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.40.1

[ci skip]

Release 0.40.1

releaser: Add release notes draft for 0.40.1

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

hugolib: Fix some shortcode vs .Content corner cases

This is a follow-up to #4632. There were some assumptions in that implementation that did not hold water in all situations.

This commit simplifies the content lazy initalization making it more robust.

Fixes #4664

releaser: Prepare repository for 0.41-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.40

[ci skip]

Release 0.40

releaser: Add release notes draft for 0.40

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

hugolib: Add .Page.BundleType

I eturn either:

1. leaf
2. branch
3. empty string

The above sits well with constructs like:

```
{{ with .BundleType }}
// Now we know it is a bundle
{{ end }}
```

Fixes #4662

hugolib: Add zero-based Ordinal to shortcode

The count starts at 0 relative to the shortcode's parent: Either the page or the surrounding shortcode.

Access it in a shortcode like this:

```bash
Ordinal is {{ .Ordinal }}
```

Note that this is a shared ordinal for all shortcodes in the relevant context, so, as an example, you have this in a content page:

```markdown
This is a shortcode:

{{< hello >}}

This is another shortcode:

{{< hugo >}}

The `.Ordinal` you get in the two shortcodes above is 0 and 1.
```

See #3359

hugolib: Defer the unlock in orderedMap.Add

Just in case someone tries to recover from the potential panic.

Squashed 'docs/' changes from 76e881257..896bad9f4

896bad9f4 Remove unused files below /static

git-subtree-dir: docs
git-subtree-split: 896bad9f4f7ed487b357e2842bccc55fb8d090cd

Merge commit 'a215abf70e018f4bf40d6c09d8bd148d8684b33d'

hugolib: Process and render shortcodes in their order of appearance

Fixes #3359

hugolib: Init the content and shortcodes early

In most cases we could delay the content init until rendering time, but there could be use cases where the templates would depend on state set in the shortcodes (.Page.Scratch.Set), so we  need to do this early.

See #4632

tpl/path: Add path.Ext, path.Dir and path.Base

tpl/os: Make fileExist use the same filesystem as readFile

Fixes #4633

Merge commit 'd2ec1a06df8ab6b17ad05cb008d5701b40327d47'

Squashed 'docs/' changes from f9a5dc59b..76e881257

76e881257 Improve .Scratch entry (#454)
37ed09702 Remove zero-byte .gitmodules file altogether
943f21619 Add a note about valid values for taxonomies in front-matter
ebcfa30d7 Update definition list formatting
46050042a Corrected formatting
87c539101 Updated readFile documentation
8fd130395 commands: Regenerate the CLI docs
6ce0ce8d6 data: Regenereate the docshelper
9fe78fabd Release 0.39
33039c6ba releaser: Prepare repository for 0.40-DEV
e3a780907 releaser: Add release notes to /docs for release of 0.39
54406e3fa releaser: Bump versions for release of 0.39
21017660b Merge commit '047c4188dfc854f658d16f1e4a9501f9c97a31c7'

git-subtree-dir: docs
git-subtree-split: 76e88125760c140541edab2061aed31c6db2d800

Make .Content (almost) always available in shortcodes

This resolves some surprising behaviour when reading other pages' content from shortcodes. Before this commit, that behaviour was undefined. Note that this has never been an issue from regular templates.

It will still not be possible to get **the current shortcode's  page's rendered content**. That would have impressed Einstein.

The new and well defined rules are:

* `.Page.Content` from a shortcode will be empty. The related `.Page.Truncated` `.Page.Summary`, `.Page.WordCount`, `.Page.ReadingTime`, `.Page.Plain` and `.Page.PlainWords` will also have empty values.
* For _other pages_ (retrieved via `.Page.Site.GetPage`, `.Site.Pages` etc.) the `.Content` is there to use as you please as long as you don't have infinite content recursion in your shortcode/content setup. See below.
* `.Page.TableOfContents` is good to go (but does not support shortcodes in headlines; this is unchanged)

If you get into a situation of infinite recursion, the `.Content` will be empty. Run `hugo -v` for more information.

Fixes #4632
Fixes #4653
Fixes #4655

Revert "Improve .Content vs shortcodes"

This reverts commit e590cc26eb1363a4b84603f051b20bd43fd1f7bd.

Revert "hugolib: Prepare child page resources before the page itself"

This reverts commit 3238e14fdfeedf189a5af122e20bff040ac059bd.

hugolib: Prepare child page resources before the page itself

To make sure that the child resources' content is ready before any shortcode is processed in their owner.

See #4632

Add language merge support for Pages in resource.Resources

Fixes #4644

Improve .Content vs shortcodes

For the content from other pages in shortcodes there are some chicken and
egg dependencies that is hard to get around. But we can improve on this  by preparing the pages in a certain order:

 1. The headless bundles goes first. These are page typically page and image collections..
 2. Leaf bundles
 3. Regular single pages
 4. Branch bundles

Fixes #4632

Improve .Get docs

Update missing positional parameter test for .Get

.Get doesn't crash on missing positional param
fixes #4619

.Get function: fix syntax signature

Improve error message in metadata parse

Fixes #3696

hugolib: Fix broken test

parser: Add some context to front matter parse error

Fixes #4638

Updated GetCSV error message (#4636)

releaser: Prepare repository for 0.40-DEV

[ci skip]