Split go build in Dockerfile

To maximize the usage of cache, split the govendor get in steps:
- govendor fetch to get the pinned versions of dependencies
- go install to actually build the binary

Doing so allows not to re-download the whole dependencies when changing
lines in hugo repository

The current Dockerfile generates an image of 16.6MB

Signed-off-by: Thibault Jamet <tjamet@users.noreply.github.com>

Update Dockerfile to benefit build cache

Docker has recently introduces buikld-stages (as of version 17.05)

Build stages allows to benefit the docker build cache as well as
reducing the size of the resulting image c.f.
https://docs.docker.com/engine/userguide/eng-image/multistage-build/

This change allows to have faster builds when running `docker build`
several times after changing some little code

Signed-off-by: Thibault Jamet <tjamet@users.noreply.github.com>

snap: Add git to snap package for GitInfo

Add git into the staged packages, so that the git binary is available
and hugo --enableGitInfo works for users of the snap package.

Fixes gohugoio/hugo#3896

releaser: Prepare repository for 0.29-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.28

[ci skip]

releaser: Add final 0.28 release notes

releaser: Add release notes draft for 0.28

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

Merge commit '61c27b58b353c73772aae572c7d822fdfdf7791b'

Squashed 'docs/' changes from 1662b9d0..20959c7b

20959c7b Rewrite the syntax highlighter docs etc.
92435459 Add a note about branches
REVERT: 1662b9d0 Add missing Disqus links in templates/internal.md

git-subtree-dir: docs
git-subtree-split: 20959c7b9124341dfc4d139748244818b9cb3641

Merge commit '30694a133a88d5f76a51d0372646e10cbeca7691'

Squashed 'docs/' changes from 5be6fef0..1662b9d0

1662b9d0 Add missing Disqus links in templates/internal.md

git-subtree-dir: docs
git-subtree-split: 1662b9d0bcb6b8ebdb665f7a477d38c93c5f8faf

Use Chroma as new default syntax highlighter

If you want to use Pygments, set `pygmentsUseClassic=true` in your site config.

Fixes #3888

tpl: Add urls.Parse function

Add a urls.Parse template function that front-ends url.Parse from the Go
stdlib.

Fixes #3849

tpl: Add math.Ceil, Floor, and Round

Ceil and Floor are frontends for the stdlib math functions. The Round
implementation is essentially the same thing except that the Go stdlib
doesn't include a Round implementation in a stable release yet.  I've
included the Round function slated for Go 1.10.

Fixes #3883

Make noHTTPCache default on

This is a development server, so that makes the most sense.

See #3897

Trim newlines in the hightlight shortcode

Fixes #3898

vendor: Update goorgeous

Fixes #3899

Add liveReloadPort flag to server

This makes live reloading behind a HTTPS proxy working, as in the example below using the service from https://ngrok.com:

```
hugo server -b https://ba6sdfe72.ngrok.io --appendPort=false --liveReloadPort=443 --navigateToChanged
```

Fixes #3882

Fix the docs helper tool

Allow the pull-docs script to pull other than master

Squashed 'docs/' changes from 32356e4e..5be6fef0

5be6fef0 Fix typo, {{Content} should be {{.Content}}

git-subtree-dir: docs
git-subtree-split: 5be6fef0b00d06a0c780397c4f4ac8db31b56456

Merge commit '7a89dce53bfbd67a17442a8f9be8fa895fc4f9b1'

commands: Remove superflous space

commands: Rename noHttpCache to noHTTPCache

Add noHttpCache to hugo server

Fixes #3897

Merge commit 'ba45da9d03056447e4873de13d4e0f8d658a769b'

Squashed 'docs/' changes from 44fe0285..32356e4e

32356e4e Fix typo in header of shortcode-templates.md
c8f1a2d2 Correct code example for index template function
bfa6a55d Escape code fencing
ff8b2f99 Fix typos in deployment with wercker tutorial
557c36e8 theme: Merge commit '7fbb4bed25001182bfeb91f79db0f0c1936582ee'
7fbb4bed Squashed 'themes/gohugoioTheme/' changes from 7dd8a302..ca53082d
ce31cee0 Add "See Also" config
158cee1b Make the tags into keywords
61600be6 Add a note to the related section
49edb5a2 Relase 0.27.1
c9bbc001 releaser: Add release notes to /docs for release of 0.27.1
213c6c3b Add bugs poster
8b4590cd Add KeyCDN integration tutorial
2b277859 Add tutorial videos to several docs pages
950fef1f Update roadmap to link to the correct milestones page
496f5bf6 Rename relnotes
d6f9378d Bump Netlify versions to 0.27
087fde7f Update 0.27 release notes
603f94ae docs: Document Related Content
3790f6a3 releaser: Bump versions for release of 0.27
0948868c releaser: Add release notes to /docs for release of 0.27

git-subtree-dir: docs
git-subtree-split: 32356e4eabe357ae914f4d1d59e8ae31ce936723

releaser: Prepare repository for 0.28-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.27.1

[ci skip]

releaser: Add release notes for 0.27.1

tpl/tplimpl: Fix escaped HTML Go 1.9 multioutput issue (#3880)

Fixes #3876

snap: Bump to 1.9

Remove .goxc.json

Not in use

releaser: Prepare repository for 0.28-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.27

[ci skip]

Release of 0.27

releaser: Add release notes draft for 0.27

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

Squashed 'docs/' changes from 1d052b16..44fe0285

44fe0285 Fix links to JSON spec

git-subtree-dir: docs
git-subtree-split: 44fe0285a09f6b21cd00091fb0900b9797e81f72

docs: Merge commit '1b4319be62ba071f79e90ef32dbe92eb893429f7'

Set up Hugo release flow on CircleCI

This rewrites the release logic to use CircleCI 2.0 and its approve workflow in combination with the state of the release notes to determine what to do next.

Fixes #3779

tpl/time: Add time.Duration and time.ParseDuration template funcs

And with time.Duration with the convenient alias `duration`:

```
{{ mul 60 60 | duration "second" }}
```

Fixes #3828

tpl/compare: Add cond (ternary) template func

Fixes #3860

hugolib: Fix "published" front matter handling

Also related:

* support "modified" as an optional way to signal "last modified"
* make sure all relevant page dates are also added to params

Fixes #3867

hugolib: Fix typo in aquired

Signed-off-by: wgliang <liangcszzu@163.com>

docs: Document Related Content

See https://github.com/gohugoio/hugo/issues/98

hugolib: Implement "related content"

This closes #98, even if this commit does not do full content text search.

We may revisit that problem in the future, but that deserves its own issue.

Fixes #98

Squashed 'docs/' changes from f887bd7b..1d052b16

1d052b16 Update hosting-on-netlify.md
28b96bec Remove double brackets in Netlify hosting tutorial
373ed38b Update deployment instructions from hugo > 0.20 on Netlify
1bbb41ca Generate static assets on deploy in Nanobox tutorial
816d207f Add missing backtick in templates/views.md
bf88e772 Add nanobox as a deployment option
9c37b4cc Change config's syntax order matching description
d3cb05a7 Fix wrongly named default value of publishDir
4be85c54 Add link to showcase a theme setup via config file
46837195 Init and update of submodules in .gitlab-ci.yml
9e7c2827 Add CSS lang argument to code block
85aad56e Abstract the type in the lookup order
4e1e43e9 Fix broken Pygments url
65b4e79b Correct GitLab project pipelines URL
94af72b5 Fix .Data.Terms usage in taxonomy template example
eb371e52 functions: Fix lang.NumFmt docs
a745cd6c Fix layouts' folder name in template primer
e181e637 Correct typo on GitHub pages guide (#151)
28698500 Remove HTML special chars from Windows install example
96b1f5b5 Remove not needed escape slashes in urls.md
2e05043f Add upgrade instructions using homebrew
2a14624d Fix alias in countrunes.md
5e26bb97 Update docker image for build/publish
01424887 List the internal templates
a3ef5be9 Remove string concatenation from add (math) sample
43d12b44 Fix typo
89bafa49 Change to Asciidoc URI
4e14071e Removes an extra bracket (>) in single-page-templates.md
0938e423 Fix typo in http2 server push blog
fac55121 Fix typo in deployment with rsync tutorial

git-subtree-dir: docs
git-subtree-split: 1d052b16a1290ada12f1e28c7c0c373f86741071

docs: Merge commit '7d63a23b0c68d9cd7c7c09c2755619237bc03485'

output: Fix taxonomy term base template lookup

To make sure it uses the base templates in _default as a last resort.

Fixes #3856

release: CGO_ENABLED=0

Update Travis build to Go 1.9!

Just released: https://blog.golang.org/go1.9

livereload: Maintain the scroll position if possible

This fixes #3824: when the current pathname is the same as the one to be loaded, just call location.reload() so that the current scroll position can be preserved, instead of assigning to location.href, which will cause the scroll position to be lost.

Update template_embedded.go

Changed disqus urls from http to https. This fixes mixed content warnings on browsers when viewing Hugo websites over SSL (https).

tpl: Prepare for template metrics

tpl: Cleanup strings.TrimPrefix and TrimSuffix

These funcs were added during the move to namespaces but were
undocumented.  This commit fixes the order of the arguments and adds the
funcs to the method mapping.

tpl: Add strings.TrimLeft and TrimRight

compare, hugolib, tpl: Add Eqer interface

And use it in `eq` and `ne` so `Page` values can be compared directly in the templates without thinking about it being a `Page` or a `PageOutput` wrapper.

Fixes #3807

appveyor: Simplify

hugolib: Simplify Page.Eq

hugolib: Do not return error in Eq on type mismatch

hugolib: Rename Page.Equals to Page.Eq

To get the name in line with the template func `eq`.

hugolib: Add Page.Equals

hugolib: Rewrite replaceDivider to reduce memory allocation

```bash
name              old time/op    new time/op    delta
ReplaceDivider-4   9.76µs ±105%    7.96µs ±24%     ~     (p=0.690 n=5+5)

name              old alloc/op   new alloc/op   delta
ReplaceDivider-4    3.46kB ± 0%    1.54kB ± 0%  -55.56%  (p=0.008 n=5+5)

name              old allocs/op  new allocs/op  delta
ReplaceDivider-4      6.00 ± 0%      1.00 ± 0%  -83.33%  (p=0.008 n=5+5)
```

hugolib: Extract replaceDivider logic

To its own function and add a test and a benchmark for it.

Add an iFrame title to the YouTube shortcode

To accommodate modern web accessibility as outlined here https://dequeuniversity.com/tips/provide-iframe-titles

travis: Pull docutils out into requirements.txt

travis: Fix docutils setup

travis: Try to fix docutils setup on Linux

output: Improve the base template identification

See https://discourse.gohugo.io/t/main-block-not-rendered-in-custom-archetypes-layout/7917/3

tpl/transform: Only strip p tag in markdownify if only one paragraph

Fixes #3040

Update docs versiona and README

Closes #3791

Squashed 'docs/' content from commit f887bd7b

git-subtree-dir: docs
git-subtree-split: f887bd7b4e3e7c7e76cd63951e5b0d37d8fe0ac7

Merge commit 'ec4e6f9df2ab9ffdc62a3f59675369096e0d3f77' as 'docs'

docs: Re-integrate

Revert "Squashed 'docs/' changes from 35abbc86..f887bd7b"

That did not go well...

This reverts commit 0373e4310263ac9f2b0307d437dcf69cf474eb69.

Squashed 'docs/' changes from 35abbc86..f887bd7b

f887bd7b Add script to pull theme changes
e89bbb2f Update README
78155dec Merge commit '9301947b25099dd402065104b340b1a480906a74' as 'themes/gohugoioTheme'
9301947b Squashed 'themes/gohugoioTheme/' content from commit 7dd8a302
e7557a34 Remove gohugoioTheme submodule
a78bbe22 Add link to Go issue
31d1ef40 Add example for taxonomy terms with metadata
da978cc7 Fix links in Blackfriday extension documentation
950ad115 Fix reference to Blackfriday Extensions section
12d1d026 Add documentation for Blackfriday Extensions
8c2b8fb5 Fix explaination for uglyURLs config option
378aded7 Use community repository for Arch Linux installation guide
56455e7e Improve 0.26 release notes
be7db03a netlify: Build with the new 0.26
d430b2d3 Bump version to 0.26
61adaca0 releaser: Prepare repository for 0.27-DEV
abef29a6 releaser: Add release notes to /docs for release of 0.26
5937fe41 releaser: Bump versions for release of 0.26
033752f1 Merge commit 'e81208265bb3cdb7606d051a23d83aeebcb7d34d'
bec2bd12 Make the title case style guide configurable
f1739a44 Merge commit '50ec65fbe1a48475d3320775dab2c47389c02114'
a1aac0e5 helpers: Add support for French Guillemets
b8dc1592 doc: Merge commit '2c0d1ccdcd95de0bddeb39dca2e4d08f0d8056d7'
7b3e31b8 Merge commit '6dbde8d731f221b027c0c60b772ba82dad759943'
a37e7201 Bump versions to 0.26-DEV

git-subtree-dir: docs
git-subtree-split: f887bd7b4e3e7c7e76cd63951e5b0d37d8fe0ac7

Remove the theme submodule from /docs

See #3791

Add support for multiple config files via --config a.toml,b.toml,c.toml

Render task list item inside label for correct accessibility

Fixes #3303

source: Normalize UniqueID between Windows & Linux

hugolib: More spelling

all: Fix spelling

And some other minor issues.

all: gofmt -s

releaser: Prepare repository for 0.27-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.26

[ci skip]

releaser: Add release notes draft for 0.26

vendor: Update checksum for inflect

Yes, I double checked.

releaser: Update to new release notes location

Merge commit 'e81208265bb3cdb7606d051a23d83aeebcb7d34d'

Squashed 'docs/' changes from ef02e34e..35abbc86

35abbc86 Add example with taxonomy for title template func
85e28c10 Remove comment from variable in front matter example
eee8543b Remove comment from variable in front matter example
13a8e0b7 Add missing closing and opening comment tags
83531772 Replace http://example.{com,org}/ with https://example.{com,org}/
6727d820 Update gh repo for issues in config
3a58818e Add note to install Testify
19f13e61 Fix YAML examples in taxonomies.md
dc4b90db Replace old RSS template with new embedded version (#116)
00f39bd7 camelCase output format options
902a14a1 Add missing word to pretty URLs explanation

git-subtree-dir: docs
git-subtree-split: 35abbc869199b852922c024a29e2370272a7c1c8

releaser: Include stats from hugoDocs

Fixes #3727

helpers: Remove some unused funcs

Add some missing doc comments

As pointed out by the linter, some exported functions and types are
missing doc comments.
The linter warnings have been reduced from 194 to 116.
Not all missing comments have been added in this commit though.

Remove sourceRelativeLinks

Fixes #3766

helpers: Fix broken TaskList in Markdown

As per the referenced issue, if the task list in Markdown has
nothing before it, it will be rendered wrongly:

```
---
title: "My First Post"
date: 2017-07-29T20:21:57+02:00
draft: true
---

* [ ] TaskList

```

is rendered as:

```
<ul> class="task-list"
<li><input type="checkbox" disabled class="task-list-item"> TaskList</li>
</ul>
```

The problem lies in the `List` function of `HugoHTMLRenderer`, it had
a hardocded index of `4` for the first `>` of the list, it is used to
insert the class into the text before the closing bracket, but that
hardcoded index is only right when there is a newline before the
opening bracket, which is the case when there is anything in the
document before the task list, but if there is nothing, then there is
no newline, and the correct index of the first `>` will be `3`.

To fix that we're changing the hardcoded index to be dynamic by using
`bytes.Index` to find it properly. We're also adding a test case to
make sure this is tested against.

Fixes #3710

Switch from fork bep/inflect to markbates/inflect

Original package has received updates the fork hasn't.
Without fork updates are easier to maintain.