Release Hugo 0.30

Use Make for the release for now

[ci skip]

releaser: Add release notes draft for 0.30

Fix CircleCI build issue

Replace make with mage in CircleCI build

Updates #3969

Update CircleCI build to use Mage

Fixes #3969

Merge commit 'ecf5e081b5540e69f4af330233f39a07baf53846'

Squashed 'docs/' changes from 000ab7c42..4628b9ec2

4628b9ec2 commands: Regen CLI doc
2525f2ed0 data: Regenerate docs helper
6f5a0eb19 Add Hugo 0.30 poster image
72c3fac9e Merge branch 'chroma-next2' into next
364973d3f Fix typo in syntax highlighting.
ce10cc02e Update Chroma highlighting docs
9dcc4d4dd Update robots.md
1e64cb483 Rename title of cross references' page
d6dfbbc51 Add warning about MMark and TOCs
e8d259d32 Fix link to subsection in page
6adead19d Merge commit '040d8d2833c26c53cf9f0e035910821ed50e3863'
040d8d283 Squashed 'themes/gohugoioTheme/' changes from cdaa89c8..6b632895
bde95d890 Add Atlas starter kit
fc40d078d Remove page arg from examples of relref shortcode
c578620b5 Remove page arg from examples of ref shortcode
ee81931a4 Remove delimiters in YAML and TOML config examples
62d7b269f Clarify that .Lastmod automatically uses .GitInfo.AuthorDate (#226)

git-subtree-dir: docs
git-subtree-split: 4628b9ec2c52df4de673a4d6b9621a65d8e8f5a4

Add table linenos support for Chroma highlighter

Fixes #3915

Only re-render the view(s) you're working on

Hugo already, in its server mode,  support partial rebuilds. To put it simply: If you change `about.md`, only that content page is read and processed, then Hugo does some processing (taxonomies etc.) and the full site is rendered.
This commit covers the rendering part: We now only re-render the pages you work on, i.e. the last n pages you watched in the browser (which obviously also includes the  page in the example above).

To be more specific: When you are running the hugo server in watch (aka. livereload) mode, and change a template or a content file, then we do a partial re-rendering of the following:

* The current content page (if it is a content change)
* The home page
* Up to the last 10 pages you visited on the site.

This should in most cases be enough, but if you navigate to something completely different, you may see stale content. Doing an edit will then refresh that page.

Note that this feature is enabled by default. To turn it off, run `hugo server --disableFastRender`.

Fixes #3962
See  #1643

Make sure Date and PublishDate is always set to a value if one is available

Fixes #3854

Add correct config file name to verbose server log

Server logging uses the wrong variable when displaying
the configuration file name. This update changes the
log to use the `config` variable.

metrics: Reset benchmark timer

metrics: Detect partialCached candidates

This commit adds a "cache potential" column when running `hugo --templateMetrics --templateMetricsHints`.

This is only calculated when `--templateMetricsHints` is set, as these calculations has an negative effect on the other timings.

This gives a value for partials only, and is a number between 0-100 that indicates if `partial` can be replaced with `partialCached`.

100 means that all execution of the same partial resulted in the same output.

You should do  some manual research before going "all cache".

tpl: Rework the partial test and benchmarks

Simplify HugoNoGitInfo in magefile

Add mage installation step to CONTRIBUTING.md

Bump Go versions in Travis config

Change last 'make' statements to 'mage'

Minor README changes

Replace make with mage

Fixes #3937

Merge commit 'dae5a7c61cceeb0de59f2d755f63e453f71dd9b2'

Squashed 'docs/' changes from 36d7e22f5..000ab7c42

000ab7c42 Fix `ref` and `relref` shortcode usage patterns
4e7123d20 Add som code fence lang tags
21d4f97d1 Update homepage for ox-hugo tool
668969fc4 Remove superflous back ticks
f78cf6490 Fix code example
05aaee8ce Remove background color from code shortcode
dcb0998d0 Add a Build Performance page draft
50e04593a Document templateMetrics usage
67ad36691 Merge commit 'f66d59b8991c264c3366895b5e148ea810a184cd'
f66d59b89 Squashed 'themes/gohugoioTheme/' changes from ca53082d..cdaa89c8

git-subtree-dir: docs
git-subtree-split: 000ab7c423341bb215d4ccb4a9e54d3d64957e24

helpers: Fix broken test

vendor: Update deps

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