tplimpl: Output xmlns:xhtml only if there are translations available

Create magefile from Makefile

This commit makes a magefile.go that should be functionally equivalent to
the current Makefile.

tpl: Add errorf template function

Add template function that will build a string from the given format
string and arguments, then log it to ERROR. This has an intended
side-effect of causing the build to fail, when executed.

Resolves #3817

Clean up lint in various packages

Changes fall into one of the following:

- gofmt -s
- receiver name is inconsistent
- omit unused 2nd value from range
- godoc comment formed incorrectly
- err assigned and not used
- if block ends with a return statement followed by else

helpers: Fix broken Chroma test

hugolib: Fix broken hightlighter smoke test

vendor: Update dependencies

vendor: Update Chroma

Change SummaryLength to be configurable (#3924)

Move SummaryLength into the ContentSpec struct and refactor the
relevant summary functions to be methods of ContentSpec. The new
summaryLength struct member is configurable by the summaryLength config
value, and the default remains 70. Also updates hugolib/page to use the
refactored methods.

Resolves #3734

tpl: Add os.fileExists template function

Fixes #3839

Merge commit '9d68f695e782c6a83c77aff13317c7a22c694c98'

Squashed 'docs/' changes from 20959c7b..36d7e22f

36d7e22f Document fmt.{print, println} template functions
79a72fce Fix link to page variables
00342ca9 Fix broken link on highlight page
15f44952 Fix link in v0.28 release notes
0100df73 Fix code examples for math.{Ceil, Floor, Round}
a354a69b Fix broken netlify.toml
4995e5df Merge branch 'master' of github.com:gohugoio/hugoDocs
9cdd990a Hugo 0.29
463558f9 Document math.Log template function
588499af Add nohup.out to .gitignore
db8ddcf7 Change name of post files in example to use post prefix
296ec01f Add ox-hugo Emacs package to the tools section
f060d6d1 Fix math.Ceil, Floor, and Round naming
a2262d24 Document strings.TrimPrefix and TrimSuffix template functions
80c1ce63 Document strings.TrimLeft and TrimRight template functions
2921088d Document urls.Parse template function
f0133079 Document math.{ceil, floor, round} template functions
82863808 Fix typo in migration tools section
d5215d61 Add link to syntax hl docs in release notes
541f0686 Update versions
275ce2b4 Update 0.28 release notes
886713a1 Add release notes for 0.28
bed02e5f Merge branch 'next'
8e3b1ac4 Add a note about branches
1662b9d0 Add missing Disqus links in templates/internal.md

git-subtree-dir: docs
git-subtree-split: 36d7e22f5c21c550bd87782d2ddca666178fe1ff

tpl: Add float template function

Add a template function that allows conversion to float. This is
useful, for example, when passing aspect ratios into templates,
which tend to not be integers.

Fixes #3307

hugolib: Move metrics output to the end of the site build

examples: Fix `now` usage in footer

releaser: Prepare repository for 0.30-DEV

[ci skip]

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

[ci skip]

releaser: Bump versions for release of 0.29

[ci skip]

releaser: Add release notes for 0.29

tpl: Set Metrics at creation time

metrics: Fix sort order

Highest first.

Revert "vendor: Update Chroma"

This reverts commit cb8eb472602754b310eaf7a10271149d1e1f5d75.

metrics: Add simple template metrics feature

vendor: Update Chroma

commands: Make noHTTPCache default false

The other way was a mistake.

tpl: Add math.Ceil, Floor, and Round to method mappings

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]

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 '61c27b58b353c73772aae572c7d822fdfdf7791b'

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

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

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

Merge commit '30694a133a88d5f76a51d0372646e10cbeca7691'

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