Add a newScratch template func

Fixes #4685

hugolib: Do not create paginator pages for the other output formats

This is a recent regression in Hugo, where we have started to produce `/page/30/index.json` when the main output format (usually `HTML`) is set up with pagination.

For JSON this is potentially lot of superflous work and hurts performance.

This commit reinstates the earlier behaviour: We only create paginators if in use in the main output format.

And add a test for it to prevent this from happening again.

Fixes #4890

Add Hugo Piper with SCSS support and much more

Before this commit, you would have to use page bundles to do image processing etc. in Hugo.

This commit adds

* A new `/assets` top-level project or theme dir (configurable via `assetDir`)
* A new template func, `resources.Get` which can be used to "get a resource" that can be further processed.

This means that you can now do this in your templates (or shortcodes):

```bash
{{ $sunset := (resources.Get "images/sunset.jpg").Fill "300x200" }}
```

This also adds a new `extended` build tag that enables powerful SCSS/SASS support with source maps. To compile this from source, you will also need a C compiler installed:

```
HUGO_BUILD_TAGS=extended mage install
```

Note that you can use output of the SCSS processing later in a non-SCSSS-enabled Hugo.

The `SCSS` processor is a _Resource transformation step_ and it can be chained with the many others in a pipeline:

```bash
{{ $css := resources.Get "styles.scss" | resources.ToCSS | resources.PostCSS | resources.Minify | resources.Fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```

The transformation funcs above have aliases, so it can be shortened to:

```bash
{{ $css := resources.Get "styles.scss" | toCSS | postCSS | minify | fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```

A quick tip would be to avoid the fingerprinting part, and possibly also the not-superfast `postCSS` when you're doing development, as it allows Hugo to be smarter about the rebuilding.

Documentation will follow, but have a look at the demo repo in https://github.com/bep/hugo-sass-test

New functions to create `Resource` objects:

* `resources.Get` (see above)
* `resources.FromString`: Create a Resource from a string.

New `Resource` transformation funcs:

* `resources.ToCSS`: Compile `SCSS` or `SASS` into `CSS`.
* `resources.PostCSS`: Process your CSS with PostCSS. Config file support (project or theme or passed as an option).
* `resources.Minify`: Currently supports `css`, `js`, `json`, `html`, `svg`, `xml`.
* `resources.Fingerprint`: Creates a fingerprinted version of the given Resource with Subresource Integrity..
* `resources.Concat`: Concatenates a list of Resource objects. Think of this as a poor man's bundler.
* `resources.ExecuteAsTemplate`: Parses and executes the given Resource and data context (e.g. .Site) as a Go template.

Fixes #4381
Fixes #4903
Fixes #4858

output: Fix the shortcodes/partials vs base template detection

Fixes #4897

output: gofmt -l -w output/layout.go

tpl/collections: Return en empty slice in after instead of error

When the given index is out of bounds. So it can safely be used with `with` etc. without extra length checking.

Fixes #4894

Restrict the new type layout resolution to page and section kinds

Will have to test and evaluate this a little.

See  #4891

Consider root and current section's content type if set in front matter

This should allow for less duplication of templates. Before this commit it was possible to override the content page of a given page/section, but only one page at a time.

Full "template sets" can now be inherited by setting `type: blog` etc. in the section content page's front matter, and that type will be considered when looking for layouts for all pages in that section.

For nested sections, it will use consider both `type` set in the current section first, then `type` set in the first section below home, e.g. `/docs`.

This commit also adds a new Page method: `FirstSection`. This navigates up to the first section below home (e.g. `/docs`). For the home page it will return itself.

Fixes #4891

circleci: Update docker image

With Go 10.3 and newest Goreleaser and Mage.

hugolib: Allow forward slash in shortcode names

Fixes #4886

Merge branch 'release-0.42.2'

releaser: Prepare repository for 0.43-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.42.2

[ci skip]

Release 0.42.2

commands: Fix broken server-reload on config changes

This was accidently broken in Hugo 0.42.

Fixes #4878

commands: Fix broken server-reload on config changes

This was accidently broken in Hugo 0.42.

Fixes #4878

Update GoReleaser config

tpl: Remove some "debug info"

See #4881

tpl: Update internal pagination template to support Bootstrap 4

Fixes #4881

Create missing head.html partial on new theme generation

Add html doctype to baseof.html template for new themes

Revert "tpl: Support text/template/parse API change in go1.11"

Go developers have undone the breaking API changes
in the following commit:

commit bedfa4e1c37bd08063865da628f242d27ca06ec4
Author: Daniel Theophanes <kardianos@gmail.com>
Date:   Thu Jun 21 10:41:26 2018 -0700

    text/template/parse: undo breaking API changes

    golang.org/cl/84480 altered the API for the parse package for
    clarity and consistency. However, the changes also broke the
    API for consumers of the package. This CL reverts the API
    to the previous spelling, adding only a single new exported
    symbol.

    Fixes #25968

    Change-Id: Ieb81054b61eeac7df3bc3864ef446df43c26b80f
    Reviewed-on: https://go-review.googlesource.com/120355
Reviewed-by: Daniel Martí <mvdan@mvdan.cc>
Reviewed-by: Rob Pike <r@golang.org>
    Run-TryBot: Daniel Martí <mvdan@mvdan.cc>
    TryBot-Result: Gobot Gobot <gobot@golang.org>

See https://github.com/golang/go/issues/25968

This reverts commit 9f27091e1067875e2577c331acc60adaef5bb234.

Closes #4784
Fixes #4873

appveyor: Disable asciidoctor for now

It fails on installation.

hugolib: Replace deprecated {Get,}ByPrefix with {Get,}Match

Adds .gitattributes to force Go files to LF

Even on Windows machines, we want *.go files to have LF line
endings (go fmt insists). This leaves other files as auto, but
makes *.go files always be LF on Windows machines. With this
change, running go fmt will be a pleasant operation, not a
painful one.

Note that changing .gitattributes only affects files at initial
checkout. To update an entire working directory after making a
change like this, do this (but only after committing all work in
progress, this will destroy uncommitted changes):

$ git rm --cached -r .
$ git reset --hard

Again - do not do this to a working directory with uncommitted
work in it.

Update to Go 1.9.7 and Go 1.10.3

for Travis CI, Docker and Snap

Update Dockerfile to a multi-stage build

- Hugo container is based on SCRATCH to further reduce the footprint
  and the vulnerability surface
- Update Alpine image to 3.7 in the build container
- Update Go Lang to 1.10 in the build container
- Add .dockerignore file per the Docker best practices

Closes #4154, #4155, #4157

tpl: Support text/template/parse API change in go1.11

Thanks to @rjoleary for the investigation.

Fixes #4784

releaser: Prepare repository for 0.43-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.42.1

[ci skip]

Release 0.42.1

releaser: Add release notes draft for 0.42.1

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

hugolib: Reset the global pages cache on server rebuilds

In Hugo 0.42, this could lead to errors of type `runtime error: invalid memory address or nil pointer dereference` in some rare situations.

Note that this was also an issue before 0.42, but the symptom was then potentially stale list content on rebuilds on content changes.

This commit also improves the above error message.

Fixes #4845

commands: Do not fail server build when /static is missing

This was a un-intended change in Hugo 0.42. Most sites will have a static directory so this should not be a big issue, but this commit will revert back to old behaviour.

Fixes #4846

releaser: Prepare repository for 0.43-DEV

[ci skip]

Merge tag 'v0.42'

releaser: 0.42 [ci skip]

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

[ci skip]

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