shithub: hugo

--- a/config.toml

+++ b/config.toml

@@ -71,7 +71,7 @@

 [params]

   description = "The world’s fastest framework for building websites"

   ## Used for views in rendered HTML (i.e., rather than using the .Hugo variable)

-  release = "0.29"

+  release = "0.30"

   ## Setting this to true will add a "noindex" to *EVERY* page on the site

   removefromexternalsearch = false

   ## Gh repo for site footer (include trailing slash)

--- /dev/null

+++ b/content/functions/errorf.md

@@ -1,0 +1,26 @@

+---

+title: errorf

+linktitle: errorf

+description: Evaluates a format string and logs it to ERROR.

+date: 2017-09-30

+publishdate: 2017-09-30

+lastmod: 2017-09-30

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [strings, log, error]

+signature: ["errorf FORMAT INPUT"]

+workson: []

+hugoversion:

+relatedfuncs: [printf]

+deprecated: false

+aliases: []

+---

+`errorf` will evaluate a format string, then output the result to the ERROR log.

+This will also cause the build to fail.

+```

+{{ errorf "Something went horribly wrong! %s" err }}

+```

--- /dev/null

+++ b/content/functions/fileExists.md

@@ -1,0 +1,29 @@

+---

+title: "fileExists"

+linktitle: "fileExists"

+date: 2017-08-31T22:38:22+02:00

+description: Checks whether a file exists under the given path.

+godocref:

+publishdate: 2017-08-31T22:38:22+02:00

+lastmod: 2017-08-31T22:38:22+02:00

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+signature: ["fileExists PATH"]

+workson: []

+hugoversion:

+relatedfuncs: []

+deprecated: false

+aliases: []

+---

+`fileExists` allows you to check if a file exists under a given path, e.g. before inserting code into a template:

+```

+{{ if (fileExists "static/img/banner.jpg") -}}

+<img src="{{ "img/banner.jpg" | absURL }}" />

+{{- end }}

+```

+In the example above, a banner from the `static` folder should be shown if the given path points to an existing file.

\ No newline at end of file

--- /dev/null

+++ b/content/functions/float.md

@@ -1,0 +1,26 @@

+---

+title: float

+linktitle: float

+description: Creates a `float` from the argument passed into the function.

+godocref:

+date: 2017-09-28

+publishdate: 2017-09-28

+lastmod: 2017-09-28

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [strings,floats]

+signature: ["float INPUT"]

+workson: []

+hugoversion:

+relatedfuncs: []

+deprecated: false

+aliases: []

+---

+Useful for turning strings into floating point numbers.

+```

+{{ float "1.23" }} → 1.23

+```

--- a/content/getting-started/configuration.md

+++ b/content/getting-started/configuration.md

@@ -108,6 +108,8 @@

 # if true, auto-detect Chinese/Japanese/Korean Languages in the content. (.Summary and .WordCount can work properly in CJKLanguage)

 hasCJKLanguage:             false

 languageCode:               ""

+# the length of text to show in a .Summary

+summaryLength:              70

 layoutDir:                  "layouts"

 # Enable Logging

 log:                        false

@@ -249,6 +251,8 @@

 # if true, auto-detect Chinese/Japanese/Korean Languages in the content. (.Summary and .WordCount can work properly in CJKLanguage)

 hasCJKLanguage =              false

 languageCode =                ""

+# the length of text to show in a .Summary

+summaryLength:              70

 layoutDir =                   "layouts"

 # Enable Logging

 log =                         false

--- /dev/null

+++ b/content/news/0.27-relnotes-ready.md

@@ -1,0 +1,93 @@

+---

+date: 2017-09-11

+title: "0.27"

+description: "0.27"

+categories: ["Releases"]

+---

+Hugo `0.27`comes with fast and flexible **Related Content** ([3b4f17bb](https://github.com/gohugoio/hugo/commit/3b4f17bbc9ff789faa581ac278ad109d1ac5b816) [@bep](https://github.com/bep) [#98](https://github.com/gohugoio/hugo/issues/98)). To add this to your site, put something like this in your single page template:

+```html

+{{ $related := .Site.RegularPages.Related . | first 5 }}

+{{ with $related }}

+<h3>See Also</h3>

+<ul>

+	{{ range . }}

+	<li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>

+	{{ end }}

+</ul>

+{{ end }}

+```

+The above translates to _list the five regular pages mostly related to the current page_. See the [Related Content Documentation](https://gohugo.io/content-management/related/) for details and configuration options.

+This release represents **37 contributions by 9 contributors** to the main Hugo code base.

+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@yihui](https://github.com/yihui), and [@oneleaftea](https://github.com/oneleaftea) for their ongoing contributions.

+And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.

+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),

+which has received **44 contributions by 30 contributors**. A special thanks to [@bep](https://github.com/bep), [@sdomino](https://github.com/sdomino), [@gotgenes](https://github.com/gotgenes), and [@digitalcraftsman](https://github.com/digitalcraftsman) for their work on the documentation site.

+Hugo now has:

+* 19464+ [stars](https://github.com/gohugoio/hugo/stargazers)

+* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)

+* 178+ [themes](http://themes.gohugo.io/)

+## Notes

+* We now only strip p tag in `markdownify` if there is only one paragraph. This allows blocks of paragraphs to be "markdownified" [33ae10b6](https://github.com/gohugoio/hugo/commit/33ae10b6ade67cd9618970121d7de5fd2ce7d781) [@bep](https://github.com/bep) [#3040](https://github.com/gohugoio/hugo/issues/3040)

+## Enhancements

+### Templates

+* Add `time.Duration` and `time.ParseDuration` template funcs [f4bf2141](https://github.com/gohugoio/hugo/commit/f4bf214137ebd24a0d12f16d3a98d9038e6eabd3) [@bep](https://github.com/bep) [#3828](https://github.com/gohugoio/hugo/issues/3828)

+* Add `cond` (ternary) template func [0462c96a](https://github.com/gohugoio/hugo/commit/0462c96a5a9da3e8adc78d96acd39575a8b46c40) [@bep](https://github.com/bep) [#3860](https://github.com/gohugoio/hugo/issues/3860)

+* Prepare for template metrics [d000cf60](https://github.com/gohugoio/hugo/commit/d000cf605091c6999b72d6c632752289bc680223) [@bep](https://github.com/bep)

+* Add `strings.TrimLeft` and `TrimRight` [7674ad73](https://github.com/gohugoio/hugo/commit/7674ad73825c61eecc4003475fe0577f225fe579) [@moorereason](https://github.com/moorereason)

+* compare, hugolib, tpl: Add `Eqer` interface [08f48b91](https://github.com/gohugoio/hugo/commit/08f48b91d68d3002b887ddf737456ff0cc4e786d) [@bep](https://github.com/bep) [#3807](https://github.com/gohugoio/hugo/issues/3807)

+* Only strip p tag in `markdownify` if only one paragraph [33ae10b6](https://github.com/gohugoio/hugo/commit/33ae10b6ade67cd9618970121d7de5fd2ce7d781) [@bep](https://github.com/bep) [#3040](https://github.com/gohugoio/hugo/issues/3040)

+* Cleanup `strings.TrimPrefix` and `TrimSuffix` [29a2da05](https://github.com/gohugoio/hugo/commit/29a2da0593b081cdd61b93c6328af2c9ea4eb20f) [@moorereason](https://github.com/moorereason)

+### Output

+* Improve the base template (aka `baseof.html`) identification [0019ce00](https://github.com/gohugoio/hugo/commit/0019ce002449d671a20a69406da37b10977f9493) [@bep](https://github.com/bep)

+### Core

+* Implement "related content" [3b4f17bb](https://github.com/gohugoio/hugo/commit/3b4f17bbc9ff789faa581ac278ad109d1ac5b816) [@bep](https://github.com/bep) [#98](https://github.com/gohugoio/hugo/issues/98)

+* Add `Page.Equals` [f0f49ed9](https://github.com/gohugoio/hugo/commit/f0f49ed9b0c9b4545a45c95d56340fcbf4aafbef) [@bep](https://github.com/bep)

+* Rewrite `replaceDivider` to reduce memory allocation [71ae9b45](https://github.com/gohugoio/hugo/commit/71ae9b4533083be185c5314c9c5b273cc3bd07bd) [@bep](https://github.com/bep)

+### Other

+* Set up Hugo release flow on `CircleCI` [d2249c50](https://github.com/gohugoio/hugo/commit/d2249c50991ba7b00b092aca6e315ca1a4de75a1) [@bep](https://github.com/bep) [#3779](https://github.com/gohugoio/hugo/issues/3779)

+* Maintain the scroll position if possible [7231d5a8](https://github.com/gohugoio/hugo/commit/7231d5a829f8d97336a2120afde1260db6ee6541) [@yihui](https://github.com/yihui) [#3824](https://github.com/gohugoio/hugo/issues/3824)

+* Add an `iFrame` title to the `YouTube` shortcode [919bc921](https://github.com/gohugoio/hugo/commit/919bc9210a69c801c7304c0b529df93d1dca27aa) [@nraboy](https://github.com/nraboy)

+* Remove the theme submodule from /docs [ea2cc26b](https://github.com/gohugoio/hugo/commit/ea2cc26b390476f1c605405604f8c92afd09b6ee) [@bep](https://github.com/bep) [#3791](https://github.com/gohugoio/hugo/issues/3791)

+* Add support for multiple config files via `--config a.toml,b.toml,c.toml` [0f9f73cc](https://github.com/gohugoio/hugo/commit/0f9f73cce5c3f1f05be20bcf1d23b2332623d7f9) [@jgielstra](https://github.com/jgielstra)

+* Render task list item inside `label` for correct accessibility [c8257f8b](https://github.com/gohugoio/hugo/commit/c8257f8b726478ca70dc8984cdcc17b31e4bdc0c) [@danieka](https://github.com/danieka) [#3303](https://github.com/gohugoio/hugo/issues/3303)

+* Normalize `UniqueID` between Windows & Linux [0abdeeef](https://github.com/gohugoio/hugo/commit/0abdeeef6740a3cbba0db95374853d040f2022b8) [@Shywim](https://github.com/Shywim)

+## Fixes

+### Output

+* Fix taxonomy term base template lookup [f88fe312](https://github.com/gohugoio/hugo/commit/f88fe312cb35f7de1615c095edd2f898303dd23b) [@bep](https://github.com/bep) [#3856](https://github.com/gohugoio/hugo/issues/3856)

+* Fix `published` front matter handling [202510fd](https://github.com/gohugoio/hugo/commit/202510fdc92d52a20baeaa7edb1091f6882bd95f) [@bep](https://github.com/bep) [#3867](https://github.com/gohugoio/hugo/issues/3867)

--- /dev/null

+++ b/content/news/0.27.1-relnotes-ready.md

@@ -1,0 +1,19 @@

+---

+date: 2017-09-13

+title: "0.27.1"

+description: "0.27.1"

+categories: ["Releases"]

+---

+This fixes a regression introduced in [Go 1.9](https://github.com/golang/go/issues/21844) which lead to HTML in shortcodes in multi output Hugo sites being wrongly escaped in some cases.

+* Fix escaped HTML Go 1.9 multioutput issue (#3880) [2d613dd9](https://github.com/gohugoio/hugo/commit/2d613dd905bb8eeb8af57e30ddd749a0f04fbd3c) [@bep](https://github.com/bep) [#3876](https://github.com/gohugoio/hugo/issues/3876)

+* Bump to Go 1.9 in the Snap build [642ba6ca](https://github.com/gohugoio/hugo/commit/642ba6cab24c558b16378178fe829cbc45845424) [@bep](https://github.com/bep)

--- /dev/null

+++ b/content/news/0.30-relnotes-ready.md

@@ -1,0 +1,64 @@

+---

+date: 2017-10-16

+title: "Hugo 0.30: Race Car Edition!"

+description: "Fast Render Mode boosts live reloading!"

+categories: ["Releases"]

+slug: "0.30-relnotes"

+images:

+- images/blog/hugo-30-poster.png

+---

+Hugo `0.30` is the **Race Car Edition**. Hugo is already very very fast, but much wants more. So we added **Fast Render Mode**. It is hard to explain, so start the Hugo development server with `hugo server` and start editing. Live reloads just got so much faster! The "how and what" is discussed in lenghts [other places](https://github.com/gohugoio/hugo/pull/3959), but the short version is that we now re-render only the parts of the site that you are working on.

+The second performance related feature is a follow up to the Template Metrics added in Hugo `0.29`. Now, if you add the flag `--templateMetricsHints`, we will calculate a score for how your partials can be cached (with the `partialCached` template func).

+This release also more or less makes the really fast Chroma highlighter a complete alternative to Pygments. Most noteable is the new table `linenos` support ([7c30e2cb](https://github.com/gohugoio/hugo/commit/7c30e2cbb08fdf0e61f80c7f1aa29909aeca4211) [@bep](https://github.com/bep) [#3915](https://github.com/gohugoio/hugo/issues/3915)), which makes copy-and-paste code blocks much easier.

+This release represents **31 contributions by 10 contributors** to the main Hugo code base.

+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@digitalcraftsman](https://github.com/digitalcraftsman), and [@bmon](https://github.com/bmon) for their ongoing contributions.

+And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.

+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),

+which has received **26 contributions by 15 contributors**. A special thanks to [@bep](https://github.com/bep), [@digitalcraftsman](https://github.com/digitalcraftsman), [@moorereason](https://github.com/moorereason), and [@kaushalmodi](https://github.com/kaushalmodi) for their work on the documentation site.

+Hugo now has:

+* 20195+ [stars](https://github.com/gohugoio/hugo/stargazers)

+* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)

+* 180+ [themes](http://themes.gohugo.io/)

+## Notes

+* Running `hugo server` will now run with the new "Fast Render Mode" default on. To turn it off, run `hugo server --disableFastRender` or set `disableFastRender=true` in your site config.

+* There have been several fixes and enhancements in the Chroma highlighter. One is that it now creates Pygments compatible CSS classes, which means that you may want ot re-generate the stylesheet. See the [Syntax Highlighting Doc](https://gohugo.io/content-management/syntax-highlighting/).

+## Enhancements

+### Performance

+* Only re-render the view(s) you're working on [60bd332c](https://github.com/gohugoio/hugo/commit/60bd332c1f68e49e6ac439047e7c660865189380) [@bep](https://github.com/bep) [#3962](https://github.com/gohugoio/hugo/issues/3962)

+* Detect `partialCached` candidates [5800a20a](https://github.com/gohugoio/hugo/commit/5800a20a258378440e203a6c4a4343f5077755df) [@bep](https://github.com/bep)

+* Move metrics output to the end of the site build [b277cb33](https://github.com/gohugoio/hugo/commit/b277cb33e4dfa7440fca3b7888026944ce056154) [@moorereason](https://github.com/moorereason)

+### Templates

+* Output `xmlns:xhtml` only if there are translations available [0859d9df](https://github.com/gohugoio/hugo/commit/0859d9dfe647db3b8a192da38ad7efb5480a29a1) [@jamieconnolly](https://github.com/jamieconnolly)

+* Add `errorf` template function [4fc67fe4](https://github.com/gohugoio/hugo/commit/4fc67fe44a3c65fc7faaed21d5fa5bb5f87edf2c) [@bmon](https://github.com/bmon) [#3817](https://github.com/gohugoio/hugo/issues/3817)

+* Add `os.FileExists` template function [28188789](https://github.com/gohugoio/hugo/commit/2818878994e906c292cbe00cb2a83f1531a21f32) [@digitalcraftsman](https://github.com/digitalcraftsman) [#3839](https://github.com/gohugoio/hugo/issues/3839)

+* Add `float` template function [57adc539](https://github.com/gohugoio/hugo/commit/57adc539fc98dcb6fba8070b9611b8bd545f6f7f) [@x3ro](https://github.com/x3ro) [#3307](https://github.com/gohugoio/hugo/issues/3307)

+* Rework the partial test and benchmarks [e2e8bcbe](https://github.com/gohugoio/hugo/commit/e2e8bcbec34702a27047b91b6b007a15f1fc0797) [@bep](https://github.com/bep)

+### Other

+* Change `SummaryLength` to be configurable (#3924) [8717a60c](https://github.com/gohugoio/hugo/commit/8717a60cc030f4310c1779c0cdd51db37ad636cd) [@bmon](https://github.com/bmon) [#3734](https://github.com/gohugoio/hugo/issues/3734)

+* Replace `make` with `mage` in CircleCI build [fe71cb6f](https://github.com/gohugoio/hugo/commit/fe71cb6f5f83cdc8374cf1fc35a6d48102bd4b12) [@bep](https://github.com/bep) [#3969](https://github.com/gohugoio/hugo/issues/3969)

+* Add table `linenos` support for Chroma highlighter [7c30e2cb](https://github.com/gohugoio/hugo/commit/7c30e2cbb08fdf0e61f80c7f1aa29909aeca4211) [@bep](https://github.com/bep) [#3915](https://github.com/gohugoio/hugo/issues/3915)

+* Replace `make` with `mage` [8d2580f0](https://github.com/gohugoio/hugo/commit/8d2580f07c0253e12524a4b5c13165f876d00b21) [@bep](https://github.com/bep) [#3937](https://github.com/gohugoio/hugo/issues/3937)

+* Create `magefile` from `Makefile` [384a6ac4](https://github.com/gohugoio/hugo/commit/384a6ac4bd2de16fcd6a1c952e7ca41b66023a12) [@natefinch](https://github.com/natefinch)

+* Clean up lint in various packages [47fdfd51](https://github.com/gohugoio/hugo/commit/47fdfd5196cd24a23b30afe1d88969ffb413ab59) [@moorereason](https://github.com/moorereason)

+## Fixes

+* Make sure `Date` and `PublishDate` is always set to a value if one is available [6a30874f](https://github.com/gohugoio/hugo/commit/6a30874f19610a38e846e120aac03c68e12f9b7b) [@bep](https://github.com/bep) [#3854](https://github.com/gohugoio/hugo/issues/3854)

+* Add correct config file name to verbose server log [15ec031d](https://github.com/gohugoio/hugo/commit/15ec031d9818d239bfbff525c00cd99cc3118a96) [@mdhender](https://github.com/mdhender)

--- a/netlify.toml

+++ b/netlify.toml

@@ -3,15 +3,15 @@

   command = "hugo"

 [context.production.environment]

-  HUGO_VERSION = "0.29"

+  HUGO_VERSION = "0.30"

   HUGO_ENV = "production"

   HUGO_ENABLEGITINFO = "true"

 [context.deploy-preview.environment]

-  HUGO_VERSION = "0.29"

+  HUGO_VERSION = "0.30"

 [context.branch-deploy.environment]

-  HUGO_VERSION = "0.29"

+  HUGO_VERSION = "0.30"

 [context.next.environment]

   HUGO_BASEURL = "https://next--gohugoio.netlify.com/"