releaser: Bump versions for release of 0.42

[ci skip]

Release 0.42

releaser: Add release notes draft for 0.42

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

docs: Update theme documentation

See #4460

docs: Remove some files now moved

Merge commit 'b239595af5a9fc1fc9a1ccc666c3ab06ccc32f04'

Squashed 'docs/' changes from 0fd7b4169..501c6e233

501c6e233 Remoe speakerdeck example
9529bd27d Fix typos
530f22cd3 Remove language assuming knowledge of GitHub OAuth
c618809e7 Refer to Go by its proper name, not its domain name
06e23168b Add timeout parameter to configuration docs
034fa62a7 Update shortcodes.md
10ea79335 Document .Ordinal on shortcode
0bfd85fb9 Formatting
e44f80fdf Release 0.41
76164258c releaser: Add release notes to /docs for release of 0.41
8d87505eb releaser: Bump versions for release of 0.41
2bbc003ee docs: Document the GDPR Privacy Config
e2d11564d Merge commit 'd2b1030060d3c91d5f9ffa3456418da16bd74f1d'

git-subtree-dir: docs
git-subtree-split: 501c6e23370fae21e2110e0d7ea0db6731b31779

commands: Create LICENSE rather than LICENSE.md in "new theme"

See also #4623

commands: Create _default/baseof.html in "new theme"

Thanks to @digitalcraftsman, @bep and @rdwatters for providing the
actual content of the default baseof.html file.

Fixes #3576

commands: Make "new theme" feedback more intuitive

commands: Move nextStepsText() to new_site.go

Add support for theme composition and inheritance

This commit adds support for theme composition and inheritance in Hugo.

With this, it helps thinking about a theme as a set of ordered components:

```toml
theme = ["my-shortcodes", "base-theme", "hyde"]
```

The theme definition example above in `config.toml` creates a theme with the 3 components with presedence from left to right.

So, Hugo will, for any given file, data entry etc., look first in the project, and then in `my-shortcode`, `base-theme` and lastly `hyde`.

Hugo uses two different algorithms to merge the filesystems, depending on the file type:

* For `i18n` and `data` files, Hugo merges deeply using the translation id and data key inside the files.
* For `static`, `layouts` (templates) and `archetypes` files, these are merged on file level. So the left-most file will be chosen.

The name used in the `theme` definition above must match a folder in `/your-site/themes`, e.g. `/your-site/themes/my-shortcodes`. There are  plans to improve on this and get a URL scheme so this can be resolved automatically.

Also note that a component that is part of a theme can have its own configuration file, e.g. `config.toml`. There are currently some restrictions to what a theme component can configure:

* `params` (global and per language)
* `menu` (global and per language)
* `outputformats` and `mediatypes`

The same rules apply here: The left-most param/menu etc. with the same ID will win. There are some hidden and experimental namespace support in the above, which we will work to improve in the future, but theme authors are encouraged to create their own namespaces to avoid naming conflicts.

A final note: Themes/components can also have a `theme` definition in their `config.toml` and similar, which is the "inheritance" part of this commit's title. This is currently not supported by the Hugo theme site. We will have to wait for some "auto dependency" feature to be implemented for that to happen, but this can be a powerful feature if you want to create your own theme-variant based on others.

Fixes #4460
Fixes #4450

hugolib: Make sure that .Site.Taxonomies is always set on rebuilds

Fixes #4838

tpl: Always load GA script over HTTPS

tplimpl: Remove speakerdeck shortcode

Fixes #4830

hugolib: Reset Page's main output on server rebuilds

Not doing so prevents the paginators to be rebuilt on changes.

Fixes #4819

Reset the "distinct error logger" on rebuilds

Fixes #4818

tpl/strings: strings.RuneCount

tpl: Prevent isBaseTemplate() from matching "baseof" in dir

Fixes #4809

tpl/strings: Remove overflow check in strings.Repeat

The test fails on 32 bit systems. Let it panic instead.

tpl/strings: Adjust the overflow validation in strings.Repeat

This now matches the validation in the stdlib, but we return an error instead.

tpl: Add strings.Repeat

Fixes #4798

tpl: Remove frameborder attr YT iframe + CSS fixes

Fix vimeo_simple thumb scaling

Add vimeo_simple

Fixes #4749

Add a BlackFriday option for rel="noreferrer" on external links

Add a configuration option "noreferrerLinks". When set to "true" the "HTML_NOREFERRER_LINKS" flag is being passed to Blackfriday. Thereby all *absolute* links will get a "noreferrer" value for their "rel" attribute.

See #4722

hugolib: A little more on shortcode ordinal

Add a BlackFriday option for rel="nofollow" on external links

Add a configuration option "nofollowLinks". When set to "true" the "HTML_NOFOLLOW_LINKS" flag is being passed to Blackfriday. Thereby all *absolute* links will get a "nofollow" value for the "rel" attribute.

Fixes #4722

fix typo instagram_simple

releaser: Prepare repository for 0.42-DEV

[ci skip]

dep: Update Chroma

And be explicit about the revision. Chroma seem to be a little bit lazy with tagging.

Fixes #4779

Enhance Page and Resource String()

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