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]

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

[ci skip]

releaser: Bump versions for release of 0.39

[ci skip]

releaser: Fix LICENSE vs LICENSE.md

Fixes #4631

Release 0.39

releaser: Add release notes draft for 0.39

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

commands: Re-add the missing releaser command

Merge commit '047c4188dfc854f658d16f1e4a9501f9c97a31c7'

Squashed 'docs/' changes from d9c8fc220..f9a5dc59b

f9a5dc59b Code Toggle block added to doc site final batch Templates ✅ Variables ✅
4d4107968 Add eSolia as new sponsor
000fed94e Add missing closing tags for li in menu template example
f462b620f Clarify that local CSV files cannot be inside data dir
ae083641a Added hugo-search-index to list of search tools
e2b64d0b7 Remove extra link
2fb4c9af5 Release 0.38.2
59b1c9853 releaser: Prepare repository for 0.39-DEV
92f6a05ea releaser: Add release notes to /docs for release of 0.38.2
76244729e releaser: Bump versions for release of 0.38.2
0960c5fb3 Adjust gray color of tab vs pane in code-toggle.
8ae3aadd7 use code-toggle shortcode when relevant Content Management ✅
455b8b53b Update related.md
6e8d19090 Release 0.38.1
079ba044c releaser: Prepare repository for 0.39-DEV
6f23e6ec1 releaser: Add release notes to /docs for release of 0.38.1
c51692ceb releaser: Bump versions for release of 0.38.1
d37ea6a5e Update related.md
faa2707d0 Update index.md
9ce901dcb Add a forgotten language tag (go-html-template) for code
b05aaed14 Update where.md
4d4760819 Fix typo in code-toggle.md
c5a5250a1 Use the new go-html-template Chroma lexer
2de831f4b Add the full list of Chroma lexers
18114d4b4 Update Output Formats
b069d7f84 Release 0.38
caaa8355a releaser: Prepare repository for 0.39-DEV
e45b7cc9f releaser: Add release notes to /docs for release of 0.38
40f40906e releaser: Bump versions for release of 0.38
2d52e2e4e Merge commit 'ed8bf081fdbf336e026517b7e1b123c039014ab5'
1439f64a0 docs: Generate docshelper data
5b0edfd79 Add .Site.IsServer
fdb579ad1 Merge commit '0a23baa6a90901f772c234107c4f12c16c76f4aa'
7b71da1f8 hugolib: Add Reset method to delete key from Scratch
63a131664 docs: Add docs for lang.Merge
55cba056d Merge commit '3886fc1fef6ac19d58b9ba1bb642d0c6c9a54031'
6f301ebcc docs: Add docs on the new front matter configuration
7ba35ef56 Merge commit 'c0290655825e7bb36e13fb39f89d85b392cf1adc'
3d2cab754 releaser: Prepare repository for 0.38-DEV
095e888e1 releaser: Add release notes to /docs for release of 0.37.1
593fa0dcb releaser: Bump versions for release of 0.37.1
c18c1df54 releaser: Prepare repository for 0.38-DEV

git-subtree-dir: docs
git-subtree-split: f9a5dc59b77d15cc2c7534e10bcd90bcfeda7bb4

Remove old LICENSE.md

Closes #4623

Add a GitHub compatible Apache 2 license text

tpl/urls: Add anchorize template func

tpl/path: Add path.Join

tpl: Add path.Split template func

hugolib: Do not reset .Page.Scratch on rebuilds

Fixes #4627

resource: Implement Resource.Content

Fixes #4622

Make Page.Content a method that returns interface{}

To prepare for a `Resource.Content` method.

See #4622

source: Remove deprecated File.Bytes

commands: Remove accidental and breaking space in baseURL flag

And added key-trimming to prevent future mishaps.

See #4607

commands: Properly handle CLI slice arguments

Like `--disableKinds` -- this handling was kind of broken when we recently moved this from global vars

See #4607

commands: Correctly handle destination and i18n-warnings

And add some more CLI tests.

See #4607

commands: Fix handling of persistent CLI flags

See #4607

hugolib: Fix livereload of bundled pages

Fixes #4607

commands: Fix failing Travis server test

Allow "*/" inside commented out shortcodes

Fixes #4608

commands: Make commands.Execute return a Response object

We have no global `Hugo` object no more (yay!), and there are some external tools that depends on that value.

These tools need to use get that value from `Response.Result`.

Note that `commands.Execute` now also takes the arguments as a string slice. This should also make it easier to use, not having to modify `os.Args`.

This commit also wraps up this particular issue. Phew!

Test coverage in /commands before: 14.4%
Now:  53.5%

Still work to do, now it is at least possible.

Closes #4598

commands: Remove some TODOs

See #4598

commands: Fix the config command

It now also accepts the `-s` (source) flag.

See #4598

commands: Fix some flag diff

The CLI docs output is now identical with the master version.

See #4598

commands: Add basic server test

See #4598

commands: Fix TestFixURL

See #4598

commands: Remove the Hugo global

There are still some cleaning to do, but that felt good.

See #4598

commands: Make the limit command work again

See #4598

commands: Move the commands related logic to its own file

See #4598

commands: Add CLI tests

See #4598

commands: Make the hugo command non-global

See #4598

commands: Extract some common types into its own file

See #4598

commands: Make the server command non-global

See #4598

commands: Make the gen commands non-global

See #4598

commands: Make the list commands non-global

See #4598

commands: Make the import commands non-global

See #4598

comands: Make the config command non-global

See #4598

commands: Make the new commands non-global

See #4598

commands: Make convert command non-global

See #4598

commands: Make more commands non-global

See #4598

commands: Make benchmark non-global

See #4598

commands: Start of flag cleaning

See #4598

commands: Use short date format in CLI docs

To make it possible to compare the output.

See #4598

Update README.md

I discovered an inconsistency between the website documentation (https://gohugo.io/getting-started/installing/#source) and this README, for installing from source. I checked them both and the website seems to be newer so I would like to propose updating this README to install Hugo using mage (unless it doesn't really matter).

Sync dependencies

Bump Go versions

Fixes #4545

releaser: Prepare repository for 0.39-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.38.2

[ci skip]

Release 0.38.2

releaser: Add release notes draft for 0.38.2

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

Bump the debouncer dependency

No practical difference.

Use a versioned debounce dependency

Fix handling of --contentDir etc. flag

We need to revisit the commands package re globals and tests, but this should fix the init order of flags and languages.

Fixes #4589

travis: Disable shallow clone to fix TestPageWithLastmodFromGitInfo

Fixes #4584

Revert "Disable failing test on Travis"

This reverts commit 2170943ae6e4bcbbcb9cfad244fec5da8c1d6462
and commit 623c9afa8409855ccfd7b000ae7c6780b780a5af.

Fix handling of content files with "." in them

As in, more dots than just to separate the extension and any language indicator.

Fixes #4559

 And now really disable failing test on Travis

 See #4584

Disable failing test on Travis

See #4584

Revert "Try an older GitMap version"

This reverts commit 3a3261a3b9565526840b1ff1bced01e1873cc6e5.

Try an older GitMap version

To test if the test failures goes away.

hugolib: Set .Parent in bundled pages to its owner

Fixes #4582

releaser: Prepare repository for 0.39-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.38.1

[ci skip]

Release 0.38.1

releaser: Add release notes draft for 0.38.1

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

Fix livereload for the home page bundle

Fixes #4576

snap: Revert to "mage test" because "mage check" fails

"mage check", which runs "go test", gofmt, "go vet", and
"go test -race", fails one way or another especially on
on non-amd64 architectures, and sometimes even on amd64 too.

Partially reverting my undocumented change in commit 294c0f8.

Fixes #4578

snap: Add bash completion

snap: Fix empty BuildDate in "hugo version"

Previously, "snap run hugo version" returns an empty BuildDate like so:

    Hugo Static Site Generator v0.38 linux/amd64 BuildDate:

Fix by overriding the default build target of snapcraft's go plugin.

Fix some livereload content regressions

Introduced in Hugo 0.38.

Fixes #4566

Update github.com/bep/gitmap to fix snap build

Fixes #4538

Fix two tests that are broken on Windows

Put guards around TestPageBundlerCaptureSymlinks and
TestPageBundlerSiteWitSymbolicLinksInContent so that they aren't
run on Windows (they both use symbolic links and the Go library
implementation requires administrator mode on Windows).

commands: Handle mass content etc. edits in server mode

Fixes #4563

releaser: Prepare repository for 0.39-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.38

[ci skip]

Release 0.38

releaser: Add release notes draft for 0.38

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

travis: Clean up and increase verbosity

Squashed 'docs/' changes from 3068989b9..d9c8fc220

d9c8fc220 Rebuild Chroma CSS
a9168b106 Adds missing word
ebaa172af Remove note about enabling custom GitLab domains
2ef3918b2 Add code toggler
41878b6ca Clarify the use of .GetPage with page bundles
ffcb26270 Fix broken link for configuration.md
1e72e2b3e Fixed typo in heading - Hightlighter
72b2db77c Change "on the form" to "of the form"
e15e6966f Fix example GitHub url

git-subtree-dir: docs
git-subtree-split: d9c8fc220710fe2bdcc2c61afd9e40e7233953cf

Merge commit 'ed8bf081fdbf336e026517b7e1b123c039014ab5'

docs: Generate docshelper data

And fix build ...

docshelper: List Chroma lexers

Fixes #4554

travis: Run "gem install" without sudo

Running "sudo gem install" was causing random errors like the following:

ERROR:  While executing gem ... (Errno::EACCES)
    Permission denied @ rb_sysopen - /home/travis/.rvm/gems/ruby-2.4.1/cache/asciidoctor-1.5.6.2.gem

Perhaps sudo is no longer necessary, even on OS X?  :-)