shithub: hugo

--- /dev/null

+++ b/.github/stale.yml

@@ -1,0 +1,21 @@

+# Number of days of inactivity before an issue becomes stale

+daysUntilStale: 120

+# Number of days of inactivity before a stale issue is closed

+daysUntilClose: 30

+# Issues with these labels will never be considered stale

+exemptLabels:

+  - Keep

+  - Security

+# Label to use when marking an issue as stale

+staleLabel: Stale

+# Comment to post when marking an issue as stale. Set to `false` to disable

+markComment: >

+  This issue has been automatically marked as stale because it has not had

+  recent activity. The resources of the Hugo team are limited, and so we are asking for your help.

+  If you still think this is important, please tell us why.

+  This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.

+# Comment to post when closing a stale issue. Set to `false` to disable

+closeComment: false

--- a/config.toml

+++ b/config.toml

@@ -69,7 +69,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.49.2"

+  release = "0.52"

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

   removefromexternalsearch = false

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

--- a/content/en/commands/hugo.md

+++ b/content/en/commands/hugo.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo"

 slug: hugo

 url: /commands/hugo/

@@ -74,4 +74,4 @@

 * [hugo server](/commands/hugo_server/)	 - A high performance webserver

 * [hugo version](/commands/hugo_version/)	 - Print the version number of Hugo

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_benchmark.md

+++ b/content/en/commands/hugo_benchmark.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo benchmark"

 slug: hugo_benchmark

 url: /commands/hugo_benchmark/

@@ -39,6 +39,7 @@

       --ignoreCache            ignores the cache directory

   -l, --layoutDir string       filesystem path to layout directory

       --memprofile string      path/filename for the memory profile file

+      --minify                 minify any supported output format (HTML, XML etc.)

       --noChmod                don't sync permission mode of files

       --noTimes                don't sync modification time of files

       --renderToMemory         render to memory (only useful for benchmark testing)

@@ -66,4 +67,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_check.md

+++ b/content/en/commands/hugo_check.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo check"

 slug: hugo_check

 url: /commands/hugo_check/

@@ -35,4 +35,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

 * [hugo check ulimit](/commands/hugo_check_ulimit/)	 - Check system ulimit settings

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_check_ulimit.md

+++ b/content/en/commands/hugo_check_ulimit.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo check ulimit"

 slug: hugo_check_ulimit

 url: /commands/hugo_check_ulimit/

@@ -39,4 +39,4 @@

 * [hugo check](/commands/hugo_check/)	 - Contains some verification checks

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_config.md

+++ b/content/en/commands/hugo_config.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo config"

 slug: hugo_config

 url: /commands/hugo_config/

@@ -39,4 +39,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_convert.md

+++ b/content/en/commands/hugo_convert.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo convert"

 slug: hugo_convert

 url: /commands/hugo_convert/

@@ -42,4 +42,4 @@

 * [hugo convert toTOML](/commands/hugo_convert_totoml/)	 - Convert front matter to TOML

 * [hugo convert toYAML](/commands/hugo_convert_toyaml/)	 - Convert front matter to YAML

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_convert_toJSON.md

+++ b/content/en/commands/hugo_convert_toJSON.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo convert toJSON"

 slug: hugo_convert_toJSON

 url: /commands/hugo_convert_tojson/

@@ -42,4 +42,4 @@

 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_convert_toTOML.md

+++ b/content/en/commands/hugo_convert_toTOML.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo convert toTOML"

 slug: hugo_convert_toTOML

 url: /commands/hugo_convert_totoml/

@@ -42,4 +42,4 @@

 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_convert_toYAML.md

+++ b/content/en/commands/hugo_convert_toYAML.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo convert toYAML"

 slug: hugo_convert_toYAML

 url: /commands/hugo_convert_toyaml/

@@ -42,4 +42,4 @@

 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_env.md

+++ b/content/en/commands/hugo_env.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo env"

 slug: hugo_env

 url: /commands/hugo_env/

@@ -38,4 +38,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_gen.md

+++ b/content/en/commands/hugo_gen.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo gen"

 slug: hugo_gen

 url: /commands/hugo_gen/

@@ -38,4 +38,4 @@

 * [hugo gen doc](/commands/hugo_gen_doc/)	 - Generate Markdown documentation for the Hugo CLI.

 * [hugo gen man](/commands/hugo_gen_man/)	 - Generate man pages for the Hugo CLI

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_gen_autocomplete.md

+++ b/content/en/commands/hugo_gen_autocomplete.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo gen autocomplete"

 slug: hugo_gen_autocomplete

 url: /commands/hugo_gen_autocomplete/

@@ -56,4 +56,4 @@

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_gen_chromastyles.md

+++ b/content/en/commands/hugo_gen_chromastyles.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo gen chromastyles"

 slug: hugo_gen_chromastyles

 url: /commands/hugo_gen_chromastyles/

@@ -43,4 +43,4 @@

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_gen_doc.md

+++ b/content/en/commands/hugo_gen_doc.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo gen doc"

 slug: hugo_gen_doc

 url: /commands/hugo_gen_doc/

@@ -45,4 +45,4 @@

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_gen_man.md

+++ b/content/en/commands/hugo_gen_man.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo gen man"

 slug: hugo_gen_man

 url: /commands/hugo_gen_man/

@@ -41,4 +41,4 @@

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_import.md

+++ b/content/en/commands/hugo_import.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo import"

 slug: hugo_import

 url: /commands/hugo_import/

@@ -37,4 +37,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

 * [hugo import jekyll](/commands/hugo_import_jekyll/)	 - hugo import from Jekyll

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_import_jekyll.md

+++ b/content/en/commands/hugo_import_jekyll.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo import jekyll"

 slug: hugo_import_jekyll

 url: /commands/hugo_import_jekyll/

@@ -41,4 +41,4 @@

 * [hugo import](/commands/hugo_import/)	 - Import your site from others.

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_list.md

+++ b/content/en/commands/hugo_list.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo list"

 slug: hugo_list

 url: /commands/hugo_list/

@@ -40,4 +40,4 @@

 * [hugo list expired](/commands/hugo_list_expired/)	 - List all posts already expired

 * [hugo list future](/commands/hugo_list_future/)	 - List all posts dated in the future

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_list_drafts.md

+++ b/content/en/commands/hugo_list_drafts.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo list drafts"

 slug: hugo_list_drafts

 url: /commands/hugo_list_drafts/

@@ -39,4 +39,4 @@

 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_list_expired.md

+++ b/content/en/commands/hugo_list_expired.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo list expired"

 slug: hugo_list_expired

 url: /commands/hugo_list_expired/

@@ -40,4 +40,4 @@

 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_list_future.md

+++ b/content/en/commands/hugo_list_future.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo list future"

 slug: hugo_list_future

 url: /commands/hugo_list_future/

@@ -40,4 +40,4 @@

 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_new.md

+++ b/content/en/commands/hugo_new.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo new"

 slug: hugo_new

 url: /commands/hugo_new/

@@ -17,6 +17,8 @@

 If archetypes are provided in your theme or site, they will be used.

+Ensure you run this within the root directory of your site.

```

 hugo new [path] [flags]

```

@@ -48,4 +50,4 @@

 * [hugo new site](/commands/hugo_new_site/)	 - Create a new site (skeleton)

 * [hugo new theme](/commands/hugo_new_theme/)	 - Create a new theme

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_new_site.md

+++ b/content/en/commands/hugo_new_site.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo new site"

 slug: hugo_new_site

 url: /commands/hugo_new_site/

@@ -43,4 +43,4 @@

 * [hugo new](/commands/hugo_new/)	 - Create new content for your site

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_new_theme.md

+++ b/content/en/commands/hugo_new_theme.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo new theme"

 slug: hugo_new_theme

 url: /commands/hugo_new_theme/

@@ -42,4 +42,4 @@

 * [hugo new](/commands/hugo_new/)	 - Create new content for your site

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_server.md

+++ b/content/en/commands/hugo_server.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo server"

 slug: hugo_server

 url: /commands/hugo_server/

@@ -40,6 +40,7 @@

       --cleanDestinationDir    remove files from destination not found in static directories

   -c, --contentDir string      filesystem path to content directory

   -d, --destination string     filesystem path to write files to

+      --disableBrowserError    do not show build errors in the browser

       --disableFastRender      enables full re-renders on changes

       --disableKinds strings   disable different kind of pages (home, RSS etc.)

       --disableLiveReload      watch without enabling live browser reload on rebuild

@@ -53,6 +54,7 @@

       --liveReloadPort int     port for live reloading (i.e. 443 in HTTPS proxy situations) (default -1)

       --meminterval string     interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")

       --memstats string        log memory usage to this file

+      --minify                 minify any supported output format (HTML, XML etc.)

       --navigateToChanged      navigate to changed content file on live browser reload

       --noChmod                don't sync permission mode of files

       --noHTTPCache            prevent HTTP caching

@@ -84,4 +86,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/commands/hugo_version.md

+++ b/content/en/commands/hugo_version.md

@@ -1,5 +1,5 @@

---

-date: 2018-09-24

+date: 2018-11-05

 title: "hugo version"

 slug: hugo_version

 url: /commands/hugo_version/

@@ -38,4 +38,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 24-Sep-2018

+###### Auto generated by spf13/cobra on 5-Nov-2018

--- a/content/en/content-management/front-matter.md

+++ b/content/en/content-management/front-matter.md

@@ -37,7 +37,6 @@

 ### Example

 {{< code-toggle >}}

-+++

 title = "spf13-vim 3.0 release and new website"

 description = "spf13-vim is a cross platform distribution of vim plugins and resources for Vim."

 tags = [ ".vimrc", "plugins", "spf13-vim", "vim" ]

@@ -47,8 +46,7 @@

   "VIM"

 slug = "spf13-vim-3-0-release-and-new-website"

-+++

-{{</ code-toggle >}}

+{{< /code-toggle >}}

 ## Front Matter Variables

--- a/content/en/content-management/multilingual.md

+++ b/content/en/content-management/multilingual.md

@@ -349,13 +349,7 @@

```

 {{ i18n "readingTime" .ReadingTime }}

```

-To track down missing translation strings, run Hugo with the `--i18n-warnings` flag:

-```

- hugo --i18n-warnings | grep i18n

-i18n|MISSING_TRANSLATION|en|wordCount

-```

 ## Customize Dates

 At the time of this writing, Go does not yet have support for internationalized locales, but if you do some work, you can simulate it. For example, if you want to use French month names, you can add a data file like ``data/mois.yaml`` with this content:

@@ -437,6 +431,13 @@

 {{% /note %}}

 For merging of content from other languages (i.e. missing content translations), see [lang.Merge](/functions/lang.merge/).

+To track down missing translation strings, run Hugo with the `--i18n-warnings` flag:

+```

+ hugo --i18n-warnings | grep i18n

+i18n|MISSING_TRANSLATION|en|wordCount

+```

 ## Multilingual Themes support

--- a/content/en/content-management/shortcodes.md

+++ b/content/en/content-management/shortcodes.md

@@ -15,6 +15,7 @@

 keywords: [markdown,content,shortcodes]

 draft: false

 aliases: [/extras/shortcodes/]

+testparam: "Hugo Rocks!"

 toc: true

---

@@ -239,6 +240,24 @@

 {{< instagram BWNjjyYFxVx hidecaption >}}

+### `param`

+Gets a value from the current `Page's` params set in front matter, with a fall back to the site param value. If will log an `ERROR` if the param with the given key could not be found in either.

+```bash

+{{</* param testparam */>}}

+```

+Since `testparam` is a param defined in front matter of this page with the value `Hugo Rocks!`, the above will print:

+{{< param testparam >}}

+To access deeply nested params, use "dot syntax", e.g:

+```bash

+{{</* param "my.nested.param" */>}}

+```

 ### `ref` and `relref`

--- a/content/en/contribute/themes.md

+++ b/content/en/contribute/themes.md

@@ -22,7 +22,7 @@

 A collection of all themes created by the Hugo community, including screenshots and demos, can be found at <https://themes.gohugo.io>. Every theme in this list will automatically be added to the theme site. Theme updates aren't scheduled but usually happen at least once a week.

-## tl;dr

+## Adding a theme to the list

 1. Create your theme using `hugo new theme <THEMENAME>`;

 2. Test your theme against <https://github.com/gohugoio/hugoBasicExample> \*

--- /dev/null

+++ b/content/en/functions/complement.md

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

+---

+title: "complement"

+description: "`collections.Complement` (alias `complement`) gives the elements of a collection that are not in any of the others."

+date: 2018-11-07

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [collections,intersect,union]

+signature: ["COLLECTION | complement COLLECTION [COLLECTION]..." ]

+hugoversion: "0.51"

+aliases: []

+---

+Example:

+```go-html-template

+{{ $pages := .Site.RegularPages | first 50 }}

+{{ $news := where $pages "Type" "news" | first 5 }}

+{{ $blog := where $pages "Type" "blog" | first 5 }}

+{{ $other := $pages | complement $news $blog | first 10 }}

+```

+The above is an imaginary use case for the home page where you want to display different page listings in sections/boxes on different places on the page: 5 from `news`, 5 from the `blog` and then 10 of the pages not shown in the other listings, to _complement_ them.

--- a/content/en/functions/dict.md

+++ b/content/en/functions/dict.md

@@ -22,20 +22,25 @@

 `dict` is especially useful for passing more than one value to a partial template.

-## Example: `dict` with Embedded SVGs

+## Example: Using `dict` to pass multiple values to a `partial`

-The partial below creates a SVG and expects `fill` `height` and `width` from the caller:

+The partial below creates a SVG and expects `fill`, `height` and `width` from the caller:

+**Partial definition**

 {{< code file="layouts/partials/svgs/external-links.svg" download="external-links.svg" >}}

-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" fill="{{ .fill }}" width="{{ .size }}" height="{{ .size }}" viewBox="0 0 32 32" aria-label="External Link">

+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"

+fill="{{ .fill }}" width="{{ .width }}" height="{{ .height }}" viewBox="0 0 32 32" aria-label="External Link">

 <path d="M25.152 16.576v5.696q0 2.144-1.504 3.648t-3.648 1.504h-14.848q-2.144 0-3.648-1.504t-1.504-3.648v-14.848q0-2.112 1.504-3.616t3.648-1.536h12.576q0.224 0 0.384 0.16t0.16 0.416v1.152q0 0.256-0.16 0.416t-0.384 0.16h-12.576q-1.184 0-2.016 0.832t-0.864 2.016v14.848q0 1.184 0.864 2.016t2.016 0.864h14.848q1.184 0 2.016-0.864t0.832-2.016v-5.696q0-0.256 0.16-0.416t0.416-0.16h1.152q0.256 0 0.416 0.16t0.16 0.416zM32 1.152v9.12q0 0.48-0.352 0.8t-0.8 0.352-0.8-0.352l-3.136-3.136-11.648 11.648q-0.16 0.192-0.416 0.192t-0.384-0.192l-2.048-2.048q-0.192-0.16-0.192-0.384t0.192-0.416l11.648-11.648-3.136-3.136q-0.352-0.352-0.352-0.8t0.352-0.8 0.8-0.352h9.12q0.48 0 0.8 0.352t0.352 0.8z"></path>

 </svg>

 {{< /code >}}

-These values can be stored in one object with `dict` and passed to the partial:

+**Partial call**

+The `fill`, `height` and `width` values can be stored in one object with `dict` and passed to the partial:

 {{< code file="layouts/_default/list.html" >}}

-{{ partial "svg/link-ext.svg" (dict "fill" "#01589B" "size" 10 "width" 20 ) }}

+{{ partial "svgs/external-links.svg" (dict "fill" "#01589B" "width" 10 "height" 20 ) }}

 {{< /code >}}

--- a/content/en/functions/imageConfig.md

+++ b/content/en/functions/imageConfig.md

@@ -1,4 +1,5 @@

---

+title: imageConfig

 linktitle: imageConfig

 description: Parses the image and returns the height, width, and color model.

 godocref:

--- a/content/en/functions/intersect.md

+++ b/content/en/functions/intersect.md

@@ -10,7 +10,7 @@

 menu:

   docs:

     parent: "functions"

-keywords: []

+keywords: [collections,intersect,union,complement,symdiff]

 signature: ["intersect SET1 SET2"]

 workson: []

 hugoversion:

@@ -18,8 +18,9 @@

 deprecated: false

 aliases: []

---

 An useful example is to use it as `AND` filters when combined with where:

+## AND filter in where query

```

 {{ $pages := where .Site.RegularPages "Type" "not in" (slice "page" "about") }}

--- a/content/en/functions/lang.Merge.md

+++ b/content/en/functions/lang.Merge.md

@@ -29,17 +29,13 @@

 Will "fill in the gaps" in the current site with, from left to right, content from the French site, and lastly the English.

-A more practical example is to fill in the missing translations for the "minority languages" with content from the main language:

+A more practical example is to fill in the missing translations from the other languages:

 ```bash

- {{ $pages := .Site.RegularPages }}

- {{ .Scratch.Set "pages" $pages }}

- {{ $mainSite := .Sites.First }}

- {{ if ne $mainSite .Site }}

-    {{ .Scratch.Set "pages" ($pages | lang.Merge $mainSite.RegularPages) }}

- {{ end }}

- {{ $pages := .Scratch.Get "pages" }}

+{{ $pages := .Site.RegularPages }}

+{{ range .Site.Home.Translations }}

+{{ $pages = $pages | lang.Merge .Site.RegularPages }}

+{{ end }}

```

 {{% note %}}

--- a/content/en/functions/partialCached.md

+++ b/content/en/functions/partialCached.md

@@ -19,7 +19,12 @@

 aliases: []

---

-The `partialCached` template function can offer significant performance gains for complex templates that don't need to be re-rendered on every invocation. Here is the simplest usage:

+The `partialCached` template function can offer significant performance gains for complex templates that don't need to be re-rendered on every invocation.

+**Note:** Each Site (or language) has its own `partialCached` cache, so each site will execute a partial once.

+Here is the simplest usage:

```

 {{ partialCached "footer.html" . }}

--- /dev/null

+++ b/content/en/functions/path.Base.md

@@ -1,0 +1,31 @@

+---

+title: path.Base

+description: Base returns the last element of a path.

+godocref:

+date: 2018-11-28

+publishdate: 2018-11-28

+lastmod: 2018-11-28

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [path, base]

+signature: ["path.Base PATH"]

+workson: []

+hugoversion: "0.40"

+relatedfuncs: [path.Dir, path.Ext, path.Split]

+deprecated: false

+---

+`path.Base` returns the last element of `PATH`.

+If `PATH` is empty, `.` is returned.

+**Note:** On Windows, `PATH` is converted to slash (`/`) separators.

+```

+{{ path.Base "a/news.html" }} → "news.html"

+{{ path.Base "news.html" }} → "news.html"

+{{ path.Base "a/b/c" }} → "c"

+{{ path.Base "/x/y/z/" }} → "z"

+```

--- /dev/null

+++ b/content/en/functions/path.Dir.md

@@ -1,0 +1,32 @@

+---

+title: path.Dir

+description: Dir returns all but the last element of a path.

+godocref:

+date: 2018-11-28

+publishdate: 2018-11-28

+lastmod: 2018-11-28

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [path, dir]

+signature: ["path.Dir PATH"]

+workson: []

+hugoversion: "0.40"

+relatedfuncs: [path.Base, path.Ext, path.Split]

+deprecated: false

+---

+`path.Dir` returns all but the last element of `PATH`, typically `PATH`'s directory.

+The returned path will never end in a slash.

+If `PATH` is empty, `.` is returned.

+**Note:** On Windows, `PATH` is converted to slash (`/`) separators.

+```

+{{ path.Dir "a/news.html" }} → "a"

+{{ path.Dir "news.html" }} → "."

+{{ path.Dir "a/b/c" }} → "a/b"

+{{ path.Dir "/x/y/z" }} → "/x/y"

+```

--- /dev/null

+++ b/content/en/functions/path.Ext.md

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

+---

+title: path.Ext

+description: Ext returns the file name extension of a path.

+godocref:

+date: 2018-11-28

+publishdate: 2018-11-28

+lastmod: 2018-11-28

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [path, ext, extension]

+signature: ["path.Ext PATH"]

+workson: []

+hugoversion: "0.40"

+relatedfuncs: [path.Base, path.Dir, path.Split]

+deprecated: false

+---

+`path.Ext` returns the file name extension `PATH`.

+The extension is the suffix beginning at the final dot in the final slash-separated element `PATH`;

+it is empty if there is no dot.

+**Note:** On Windows, `PATH` is converted to slash (`/`) separators.

+```

+{{ path.Ext "a/b/c/news.html" }} → ".html"

+```

--- /dev/null

+++ b/content/en/functions/path.Join.md

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

+---

+title: path.Join

+description: Join path elements into a single path.

+godocref:

+date: 2018-11-28

+publishdate: 2018-11-28

+lastmod: 2018-11-28

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [path, join]

+signature: ["path.Join ELEMENT..."]

+workson: []

+hugoversion: "0.39"

+relatedfuncs: [path.Split]

+deprecated: false

+---

+`path.Join` joins path elements into a single path, adding a separating slash if necessary.

+All empty strings are ignored.

+**Note:** All path elements on Windows are converted to slash ('/') separators.

+```

+{{ path.Join "partial" "news.html" }} → "partial/news.html"

+{{ path.Join "partial/" "news.html" }} → "partial/news.html"

+{{ path.Join "foo/baz" "bar" }} → "foo/baz/bar"

+```

--- /dev/null

+++ b/content/en/functions/path.Split.md

@@ -1,0 +1,31 @@

+---

+title: path.Split

+description: Split path immediately following the final slash.

+godocref:

+date: 2018-11-28

+publishdate: 2018-11-28

+lastmod: 2018-11-28

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [path, split]

+signature: ["path.Split PATH"]

+workson: []

+hugoversion: "0.39"

+relatedfuncs: [path.Split]

+deprecated: false

+---

+`path.Split` splits `PATH` immediately following the final slash, separating it into a directory and a base component.

+The returned values have the property that `PATH` = `DIR`+`BASE`.

+If there is no slash in `PATH`, it returns an empty directory and the base is set to `PATH`.

+**Note:** On Windows, `PATH` is converted to slash (`/`) separators.

+```

+{{ path.Split "a/news.html" }} → "a/", "news.html"

+{{ path.Split "news.html" }} → "", "news.html"

+{{ path.Split "a/b/c" }} → "a/b/", "c"

+```

--- a/content/en/functions/render.md

+++ b/content/en/functions/render.md

@@ -1,6 +1,5 @@

---

-title: render

-# linktitle: Render

+title: .Render

 description: Takes a view to apply when rendering content.

 godocref:

 date: 2017-02-01

@@ -11,7 +10,7 @@

   docs:

     parent: "functions"

 keywords: [views]

-signature: ["render LAYOUT"]

+signature: [".Render LAYOUT"]

 workson: []

 hugoversion:

 relatedfuncs: []

--- /dev/null

+++ b/content/en/functions/symdiff.md

@@ -1,0 +1,28 @@

+---

+title: "symdiff"

+description: "`collections.SymDiff` (alias `symdiff`) returns the symmetric difference of two collections."

+date: 2018-11-07

+categories: [functions]

+menu:

+  docs:

+    parent: "functions"

+keywords: [collections,intersect,union, complement]

+signature: ["COLLECTION | symdiff COLLECTION" ]

+hugoversion: "0.51"

+aliases: []

+---

+Example:

+```go-html-template

+{{ slice 1 2 3 | symdiff (slice 3 4) }}

+```

+The above will print `[1 2 4]`.

+Also see https://en.wikipedia.org/wiki/Symmetric_difference

--- /dev/null

+++ b/content/en/functions/templates.Exists.md

@@ -1,0 +1,37 @@

+---

+title: templates.Exists

+linktitle: ""

+description: "Checks whether a template file exists under the given path relative to the `layouts` directory."

+godocref: ""

+date: 2018-11-01

+publishdate: 2018-11-01

+lastmod: 2018-11-01

+categories: [functions]

+tags: []

+menu:

+  docs:

+    parent: "functions"

+ns: ""

+keywords: ["templates", "template", "layouts"]

+signature: ["templates.Exists PATH"]

+workson: []

+hugoversion: "0.46"

+aliases: []

+relatedfuncs: []

+toc: false

+deprecated: false

+---

+A template file is any file living below the `layouts` directories of either the project or any of its theme components incudling partials and shortcodes.

+The function is particulary handy with dynamic path. The following example ensures the build will not break on a `.Type` missing its dedicated `header` partial.

+```go-html-template

+{{ $partialPath := printf "headers/%s.html" .Type }}

+{{ if templates.Exists ( printf "partials/%s" $partialPath ) }}

+  {{ partial $partialPath . }}

+{{ else }}

+  {{ partial "headers/default.html" . }}

+{{ end }}

+```

\ No newline at end of file

--- a/content/en/functions/union.md

+++ b/content/en/functions/union.md

@@ -35,6 +35,7 @@

 <!-- returns an error because both arrays/slices have to be of the same type -->

```

+## OR filter in where query

 This is also very useful to use as `OR` filters when combined with where:

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

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

@@ -62,6 +62,9 @@

 buildFuture (false)

 : Include content with publishdate in the future.

+caches

+: See [Configure File Caches](#configure-file-caches)

 canonifyURLs (false)

 : Enable to turn relative URLs into absolute.

@@ -95,6 +98,9 @@

 enableGitInfo (false)

 : Enable `.GitInfo` object for each page (if the Hugo site is versioned by Git). This will then update the `Lastmod` parameter for each page using the last git commit date for that content file.

+enableInlineShortcodes

+: Enable inline shortcode support. See [Inline Shortcodes](/templates/shortcode-templates/#inline-shortcodes).

 enableMissingTranslationPlaceholders (false)

 : Show a placeholder instead of the default value or an empty string if a translation is missing.

@@ -402,6 +408,47 @@

 ## Configure Additional Output Formats

 Hugo v0.20 introduced the ability to render your content to multiple output formats (e.g., to JSON, AMP html, or CSV). See [Output Formats][] for information on how to add these values to your Hugo project's configuration file.

+## Configure File Caches

+Since Hugo 0.52 you can configure more than just the `cacheDir`. This is the default configuration:

+```toml

+[caches]

+[caches.getjson]

+dir = ":cacheDir/:project"

+maxAge = -1

+[caches.getcsv]

+dir = ":cacheDir/:project"

+maxAge = -1

+[caches.images]

+dir = ":resourceDir/_gen"

+maxAge = -1

+[caches.assets]

+dir = ":resourceDir/_gen"

+maxAge = -1

+```

+You can override any of these cache setting in your own `config.toml`.

+### The keywords explained

+:cacheDir

+: This is the value of the `cacheDir` config option if set (can also be set via OS env variable `HUGO_CACHEDIR`). It will fall back to `/opt/build/cache/hugo_cache/` on Netlify, or a `hugo_cache` directory below the OS temp dir for the others. This means that if you run your builds on Netlify, all caches configured with `:cacheDir` will be saved and restored on the next build. For other CI vendors, please read their documentation. For an CircleCI example, see [this configuration](https://github.com/bep/hugo-sass-test/blob/6c3960a8f4b90e8938228688bc49bdcdd6b2d99e/.circleci/config.yml).

+`:project`

+The base directory name of the current Hugo project. This means that, in its default setting, every project will have separated file caches, which means that when you do `hugo --gc` you will not touch files related to other Hugo projects running on the same PC.

+`:resourceDir`

+: This is the value of the `resourceDir` config option.

+maxAge

+: This is the duration before a cache entry will be evicted, -1 means forever and 0 effectively turns that particular cache off. Uses Go's `time.Duration`, so valid values are `"10s"` (10 seconds), `"10m"` (10 minutes) and `"10h"` (10 hours).

+dir

+: The absolute path to where the files for this cache will be stored. Allowed starting placeholders are `:cacheDir` and `:resourceDir` (see above).

 ## Configuration Format Specs

--- a/content/en/hosting-and-deployment/hosting-on-netlify.md

+++ b/content/en/hosting-and-deployment/hosting-on-netlify.md

@@ -128,6 +128,12 @@

 git checkout tags/<version-name>

```

+You can update a theme to the latest version by executing the following command in the *root* directory of your project:

+```

+git submodule update --rebase --remote

+```

 ## Next Steps

 You now have a live website served over https, distributed through CDN, and configured for continuous deployment. Dig deeper into the Netlify documentation:

binary files /dev/null b/content/en/news/0.50-relnotes/featured-hugo-50-poster.png differ

--- /dev/null

+++ b/content/en/news/0.50-relnotes/index.md

@@ -1,0 +1,150 @@

+---

+date: 2018-10-29

+title: "Hugo 0.50: Errors so Good, You’ll Want to Fail!"

+description: "Errors with full filename and line and column number, shown in browser. And improved Fast Render Mode …"

+categories: ["Releases"]

+---

+Hugo `0.50` brings **greatly improved error messages**, and we now also show them in the browser. Having error messages with filename, line- and column number greatly simplify troubleshooting. Many editors (like VS Code) even let you click and navigate directly to the problematic line. If your editor requires a different log format, you can set it via the `HUGO_FILE_LOG_FORMAT` OS environment variable:

+```bash

+env HUGO_FILE_LOG_FORMAT="\":file::line::col\"" hugo server

+```

+But this release isn't all about error handling. Getting line- and column number into "every" error also meant that we had to consolidate and simplify some code paths, which, as a nice side effect, made Hugo a little bit faster. Benchmarks show it running **about 5% faster and consume about 8% less memory**.

+Also, we have now implemented **"render on demand"** in Hugo's Fast Render Mode (default when running `hugo server`). This means that you should now always see updated content when navigating around the site after a change.

+This release represents **88 contributions by 14 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), [@anthonyfok](https://github.com/anthonyfok), and [@GregorioMartinez](https://github.com/GregorioMartinez) for their ongoing contributions.

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

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

+which has received **14 contributions by 9 contributors**. A special thanks to [@bep](https://github.com/bep), [@NotWoods](https://github.com/NotWoods), [@Nick-Rivera](https://github.com/Nick-Rivera), and [@tomanistor](https://github.com/tomanistor) for their work on the documentation site.

+Hugo now has:

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

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

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

+## Notes

+* You should not get stale content in Fast Render Mode anymore.

+* Errors will now show up in the browser by default, turn it off by running `hugo server --disableBrowserError`

+* `jsonify` will now produce pretty/indented output

+## Enhancements

+### Templates

+* Handle truncated identifiers in Go template errors [2d7709d1](https://github.com/gohugoio/hugo/commit/2d7709d15584e4c11138cd7fe92717a2a58e4585) [@bep](https://github.com/bep) [#5346](https://github.com/gohugoio/hugo/issues/5346)

+* Update Jsonify to return pretty-print output [5a52cd5f](https://github.com/gohugoio/hugo/commit/5a52cd5f920bb3d067ab1682adece9f813c67ba1) [@SeanPrashad](https://github.com/SeanPrashad) [#5040](https://github.com/gohugoio/hugo/issues/5040)

+* Improve the Execute panic error message [0fe4ff18](https://github.com/gohugoio/hugo/commit/0fe4ff18751156fa072e1f83077e49a8597e7dcd) [@bep](https://github.com/bep) [#5327](https://github.com/gohugoio/hugo/issues/5327)

+* Use .Lastmod in embedded schema template [c21e5179](https://github.com/gohugoio/hugo/commit/c21e5179ce9a370c416c01fbe9472be1fb5c6650) [@akshaybabloo](https://github.com/akshaybabloo) [#5320](https://github.com/gohugoio/hugo/issues/5320)

+* Cast IsSet key to int for indexed types [0d5110d0](https://github.com/gohugoio/hugo/commit/0d5110d03324380cb4a288d3fa08c1b86ba227da) [@moorereason](https://github.com/moorereason) [#3681](https://github.com/gohugoio/hugo/issues/3681)

+* Add a delimiter parameter to lang.NumFmt [ce264b93](https://github.com/gohugoio/hugo/commit/ce264b936ce9f589bd889e18762881cff8bc9cd0) [@moorereason](https://github.com/moorereason) [#5260](https://github.com/gohugoio/hugo/issues/5260)

+### Core

+* Adjust error test to make it pass on Go tip [acc14b46](https://github.com/gohugoio/hugo/commit/acc14b4646d849e09e8da37552d4f4f777d0fce2) [@bep](https://github.com/bep)

+* Rename some page_* files [e3ed4a83](https://github.com/gohugoio/hugo/commit/e3ed4a83b8e92ce9bf070f7b41780798b006e848) [@bep](https://github.com/bep)

+* Get file context in "config parse failed" errors [ed7b3e26](https://github.com/gohugoio/hugo/commit/ed7b3e261909fe425ef64216f12806840c45b205) [@bep](https://github.com/bep) [#5325](https://github.com/gohugoio/hugo/issues/5325)

+* Improve errors in /i18n handlling [2bf686ee](https://github.com/gohugoio/hugo/commit/2bf686ee217808186385bfcf6156f15bbdb33651) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Improve errors in /data handlling [9f74dc2a](https://github.com/gohugoio/hugo/commit/9f74dc2a52b6f568b5a060b7a4be47196804b01f) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Continue the file context/line number errors work [d1661b82](https://github.com/gohugoio/hugo/commit/d1661b823af25c50d3bbe5366ea40a3cdd52e237) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Remove the now superflous Source struct [7930d213](https://github.com/gohugoio/hugo/commit/7930d2132a3c36c1aaca20f16f56978c84656b0a) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Redo the summary delimiter logic [44da60d8](https://github.com/gohugoio/hugo/commit/44da60d869578423dea529db62ed613588a2a560) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Integrate new page parser [1e3e3400](https://github.com/gohugoio/hugo/commit/1e3e34002dae3d4a980141efcc86886e7de5bef8) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Use []byte in shortcode parsing [1b7ecfc2](https://github.com/gohugoio/hugo/commit/1b7ecfc2e176315b69914756c70b46306561e4d1) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Use stdlib context package [4b4af2c5](https://github.com/gohugoio/hugo/commit/4b4af2c52e658d516dd4bfaf59fef4f054dabec3) [@GregorioMartinez](https://github.com/GregorioMartinez)

+* Normalize permalink path segments [fae48d74](https://github.com/gohugoio/hugo/commit/fae48d7457de96969ec53349194dcbfa45adc269) [@moorereason](https://github.com/moorereason) [#5223](https://github.com/gohugoio/hugo/issues/5223)[#4926](https://github.com/gohugoio/hugo/issues/4926)

+* Improve error message for bad taxonomy weights [d3b81ee5](https://github.com/gohugoio/hugo/commit/d3b81ee58e8fd3a0ab8265a2898d66cbcdf6a7c1) [@moorereason](https://github.com/moorereason)

+* Cast taxonomy weight parameters to int [1fd30d46](https://github.com/gohugoio/hugo/commit/1fd30d462ee7f67fde6f29d170af1d225258322b) [@moorereason](https://github.com/moorereason) [#4628](https://github.com/gohugoio/hugo/issues/4628)

+* Allow nil to be unwrapped as *Page [498d6299](https://github.com/gohugoio/hugo/commit/498d6299581bead0f582431b8133d8b5f8760618) [@moorereason](https://github.com/moorereason) [#5043](https://github.com/gohugoio/hugo/issues/5043)

+* Be a litle more specific in NextPage TODO [fb732d53](https://github.com/gohugoio/hugo/commit/fb732d5322381ee7f3a849258419cef7bbf1487b) [@bep](https://github.com/bep)

+* Introduce Page.NextPage and Page.PrevPage [ad705aac](https://github.com/gohugoio/hugo/commit/ad705aac0649fa3102f7639bc4db65d45e108ee2) [@felicianotech](https://github.com/felicianotech) [#1061](https://github.com/gohugoio/hugo/issues/1061)

+### Other

+* Update go.sum [7082a5d1](https://github.com/gohugoio/hugo/commit/7082a5d14382acfc300ae4f66d07a14100e2358c) [@bep](https://github.com/bep)

+* Update minify [aa281b51](https://github.com/gohugoio/hugo/commit/aa281b5135db2e84b9e21b5f38a6cb63cf3ab158) [@bep](https://github.com/bep) [#5261](https://github.com/gohugoio/hugo/issues/5261)

+* Regenerate CLI docs [32501987](https://github.com/gohugoio/hugo/commit/325019872467ee152ea56329a796acf35dec6fb3) [@bep](https://github.com/bep)

+* Make sure the global logger also gets colored labels [9c88a8a5](https://github.com/gohugoio/hugo/commit/9c88a8a55adf7779039504fa77d74ec80d658c40) [@bep](https://github.com/bep) [#4414](https://github.com/gohugoio/hugo/issues/4414)

+* Avoid using the global logger [95e72f5e](https://github.com/gohugoio/hugo/commit/95e72f5e8e4634fbbb2ea7ece2156487230ad1d4) [@bep](https://github.com/bep) [#4414](https://github.com/gohugoio/hugo/issues/4414)

+* Add color to ERROR and WARN [1c7b7b4e](https://github.com/gohugoio/hugo/commit/1c7b7b4ef293aa133e5b55f3ebb2d37d8839532f) [@bep](https://github.com/bep) [#4414](https://github.com/gohugoio/hugo/issues/4414)

+* Make the file error log format configurable [1ad117cb](https://github.com/gohugoio/hugo/commit/1ad117cbe2903aa9d029f90750acf633eb2a51a2) [@bep](https://github.com/bep) [#5352](https://github.com/gohugoio/hugo/issues/5352)

+* Allow a mix of slice types in append/Scratch.Add [dac7092a](https://github.com/gohugoio/hugo/commit/dac7092a9cb22d59db28fb15af15f7b14ff47588) [@bep](https://github.com/bep) [#5361](https://github.com/gohugoio/hugo/issues/5361)

+* Allow .Data.Integrity to be accessed on its own [b27ccf34](https://github.com/gohugoio/hugo/commit/b27ccf34bf4e5ee618a66fa11c68a9690e395034) [@bep](https://github.com/bep) [#5296](https://github.com/gohugoio/hugo/issues/5296)

+* Update minify [83c873ff](https://github.com/gohugoio/hugo/commit/83c873ff37ddd379181540021232f026e7678486) [@bep](https://github.com/bep) [#5261](https://github.com/gohugoio/hugo/issues/5261)

+* Update cast [a2440dc0](https://github.com/gohugoio/hugo/commit/a2440dc0e2d46ef774305cd5e4fea5ff2bdd5f11) [@bep](https://github.com/bep) [#5340](https://github.com/gohugoio/hugo/issues/5340)

+* Truncate the error log on repeated config errors [1e9ac3dc](https://github.com/gohugoio/hugo/commit/1e9ac3dcc21e8f78d3f0a0ba4f35f6c142dfa6bc) [@bep](https://github.com/bep)

+* Regenerate CLI docs [40e99672](https://github.com/gohugoio/hugo/commit/40e99672b6f697a614485aace07ca84268f6c787) [@bep](https://github.com/bep) [#5354](https://github.com/gohugoio/hugo/issues/5354)

+* Serialize image processing [3a3badfd](https://github.com/gohugoio/hugo/commit/3a3badfd1d4b1d4c9863ecaf029512d36136fa0f) [@bep](https://github.com/bep) [#5220](https://github.com/gohugoio/hugo/issues/5220)

+* Only show Ansi escape codes if in a terminal [df021317](https://github.com/gohugoio/hugo/commit/df021317a964a482cd1cd579de5a12d50faf0d08) [@bep](https://github.com/bep)

+* Read disableFastRender from flag even if it's not changed [78a4c2e3](https://github.com/gohugoio/hugo/commit/78a4c2e32ef9ea8e92bb7bb3586e4c22b02eb494) [@bep](https://github.com/bep) [#5353](https://github.com/gohugoio/hugo/issues/5353)

+* Use overflow-x: auto; for browser errors [d4ebfea1](https://github.com/gohugoio/hugo/commit/d4ebfea1fffdc35059f42a46387e0aaf0ea877d2) [@bep](https://github.com/bep)

+* Remove the ANSI color for the browser error version [93aa6261](https://github.com/gohugoio/hugo/commit/93aa6261b4fc8caa74afef97b6304ea35dfd7d0e) [@bep](https://github.com/bep)

+* Add some color to the relevant filenames in terminal log [deff9e15](https://github.com/gohugoio/hugo/commit/deff9e154bc0371af56741ddb22cb1f9e392838a) [@bep](https://github.com/bep) [#5344](https://github.com/gohugoio/hugo/issues/5344)

+* Run gofmt -s [889aca05](https://github.com/gohugoio/hugo/commit/889aca054a267506a1c7cfaa3992d324764d6358) [@bep](https://github.com/bep)

+* Resolve error handling/parser related TODOs [6636cf1b](https://github.com/gohugoio/hugo/commit/6636cf1bea77d20ef2a72a45fae59ac402fb133b) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Improve handling of JSON errors [f669ef6b](https://github.com/gohugoio/hugo/commit/f669ef6bec25155d015b6ab231c53caef4fa5cdc) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Convert the rest to new page parser code paths [eb038cfa](https://github.com/gohugoio/hugo/commit/eb038cfa0a8ada29dfcba1204ec5c432da9ed7e0) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Consolidate the metadata decoders [129c27ee](https://github.com/gohugoio/hugo/commit/129c27ee6e9fed98dbfebeaa272fd52757b475b2) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Use []byte in page lexer [27f5a906](https://github.com/gohugoio/hugo/commit/27f5a906a2a34e3b8348c8baeea48355352b5bbb) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Add front matter etc. support [2fdc4a24](https://github.com/gohugoio/hugo/commit/2fdc4a24d5450a98cf38a4456e8e0e8e97a3343d) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* File renames and splitting [f6863e1e](https://github.com/gohugoio/hugo/commit/f6863e1ef725f654a4c869ef4955f9add6908a46) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Move the shortcode parser to the new pageparser package [d6c16afd](https://github.com/gohugoio/hugo/commit/d6c16afde0ce62cfea73447f30d6ed2b8ef4b411) [@bep](https://github.com/bep) [#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Avoid panic in error handler on config errors [6f3716dc](https://github.com/gohugoio/hugo/commit/6f3716dc22e373097a38d053f5415feca602f330) [@bep](https://github.com/bep)

+* Prevent stale content in Fast Render Mode [4a366fcf](https://github.com/gohugoio/hugo/commit/4a366fcfee24b3a5a5045b16c3b87b76147adf5e) [@bep](https://github.com/bep) [#5281](https://github.com/gohugoio/hugo/issues/5281)

+* Allow date and slug from filename for leaf bundles [1f42e47e](https://github.com/gohugoio/hugo/commit/1f42e47e475c0cd684426dd230de411d4c385a3c) [@Japanuspus](https://github.com/Japanuspus) [#4558](https://github.com/gohugoio/hugo/issues/4558)

+* Show server error info in browser [35fbfb19](https://github.com/gohugoio/hugo/commit/35fbfb19a173b01bc881f2bbc5d104136633a7ec) [@bep](https://github.com/bep) [#5284](https://github.com/gohugoio/hugo/issues/5284)[#5290](https://github.com/gohugoio/hugo/issues/5290)[#5325](https://github.com/gohugoio/hugo/issues/5325)[#5324](https://github.com/gohugoio/hugo/issues/5324)

+* Add .gitignore "hugo new site" [92979d92](https://github.com/gohugoio/hugo/commit/92979d92889ff8991acfadd42982c2e55d01b163) [@napei](https://github.com/napei)

+* Optimize integrity string generation [0a3340e9](https://github.com/gohugoio/hugo/commit/0a3340e95254597bc8a9feb250f2733b7d51edf8) [@moorereason](https://github.com/moorereason)

+* Add help text to "hugo new" [6b21ac3e](https://github.com/gohugoio/hugo/commit/6b21ac3e67cb101255e8c3d9dbf076391a9eed8d) [@elliotforbes](https://github.com/elliotforbes)

+* Set "extended" tag based on build_url on Launchpad [d1442053](https://github.com/gohugoio/hugo/commit/d14420539ac04d31dde2252eee66d7e4c7749780) [@anthonyfok](https://github.com/anthonyfok)

+* Call rst2html directly on *nix [3d4a9882](https://github.com/gohugoio/hugo/commit/3d4a9882bfc81215fb4f9eba8859324958747d4a) [@shreyanshk](https://github.com/shreyanshk)

+* Update URLs to stop 301 redirects [bdca9727](https://github.com/gohugoio/hugo/commit/bdca9727944e4cbb5a9372a8404e948ffea7c31c) [@benabbottnz](https://github.com/benabbottnz)

+* Merge branch 'release-0.49.2' [604ddb90](https://github.com/gohugoio/hugo/commit/604ddb90c5d6f1ca5583be1ec0ea8e48f014741a) [@bep](https://github.com/bep)

+* Release 0.49.2 [c397f2c0](https://github.com/gohugoio/hugo/commit/c397f2c08087cf4cda3abe2d146e30f58d6d3216) [@bep](https://github.com/bep)

+* Merge branch 'release-0.49.1' [3583dd6d](https://github.com/gohugoio/hugo/commit/3583dd6d713c243808b5e8724b32565ceaf66104) [@bep](https://github.com/bep)

+* Relase 0.49.1 [235acf22](https://github.com/gohugoio/hugo/commit/235acf22321475895442ce49ca5d16be273c1e1f) [@bep](https://github.com/bep)

+* Improve append in Scratch [23f48c30](https://github.com/gohugoio/hugo/commit/23f48c300cb5ffe0fe43c88464f38c68831a17ad) [@bep](https://github.com/bep) [#5275](https://github.com/gohugoio/hugo/issues/5275)

+* Add GOPATH Hugo building tip [b5e17f7c](https://github.com/gohugoio/hugo/commit/b5e17f7c837ce796e1094c8033fa7084510402fb) [@bep](https://github.com/bep)

+* Consolidate MakeSegment vs MakePathSanitized [e421696d](https://github.com/gohugoio/hugo/commit/e421696d02bfb8764ae57238e211ce0e85e9782e) [@bep](https://github.com/bep) [#4926](https://github.com/gohugoio/hugo/issues/4926)

+* Render Markdown in figure shortcode "caption" and "attr" params [68181703](https://github.com/gohugoio/hugo/commit/6818170308994b5f01dec7a559f92d6c7c5ca100) [@kaushalmodi](https://github.com/kaushalmodi)

+* Re-organize the figure shortcode for better readability [c5279064](https://github.com/gohugoio/hugo/commit/c5279064df9664d6b2ad277e2fba1e4bb3b0f4be) [@kaushalmodi](https://github.com/kaushalmodi)

+* Update README & CONTRIBUTING [152cffb1](https://github.com/gohugoio/hugo/commit/152cffb13a237651c2277dc6c2c9e4172d58b3df) [@GregorioMartinez](https://github.com/GregorioMartinez)

+* Add custom x-nodejs plugin to support ppc64el and s390x [91f49c07](https://github.com/gohugoio/hugo/commit/91f49c0700dde13e16f42c745584a0bef60c6fe2) [@anthonyfok](https://github.com/anthonyfok)

+* Fetch mage with GO111MODULE=off [a475bf12](https://github.com/gohugoio/hugo/commit/a475bf125cd76dacc1bf7ccbcc263a7b59efc510) [@anthonyfok](https://github.com/anthonyfok)

+* Use build-snaps instead of building go from source [fa873a6c](https://github.com/gohugoio/hugo/commit/fa873a6cb3f0fa81002fcd725ecd52fc4b9df48f) [@anthonyfok](https://github.com/anthonyfok)

+* Skip "mage -v test" due to build failure on Launchpad [52ac85fb](https://github.com/gohugoio/hugo/commit/52ac85fbc4d4066b5e13df454593597df0166262) [@anthonyfok](https://github.com/anthonyfok)

+* Move snapcraft.yaml to snap/snapcraft.yaml [27d42111](https://github.com/gohugoio/hugo/commit/27d4211187d4617f4b3afa970f91349567886748) [@anthonyfok](https://github.com/anthonyfok)

+* Update the temp docker script [48413d76](https://github.com/gohugoio/hugo/commit/48413d76f44ecfc9b90f9df63974080f6b285667) [@bep](https://github.com/bep)

+## Fixes

+### Templates

+* Fix baseof.html in error message [646a52a5](https://github.com/gohugoio/hugo/commit/646a52a5c5f52890f2d0270b68ba0f863047484a) [@bep](https://github.com/bep) [#5288](https://github.com/gohugoio/hugo/issues/5288)

+* Fix handling of different interface types in Slice [10ac2ec4](https://github.com/gohugoio/hugo/commit/10ac2ec4466090957e1f6897906ddeb1e0b13673) [@bep](https://github.com/bep) [#5269](https://github.com/gohugoio/hugo/issues/5269)

+### Core

+* Fix test on Windows [083311d0](https://github.com/gohugoio/hugo/commit/083311d0336ced35909b3375950f7817ecf95ed0) [@bep](https://github.com/bep)

+* Fix FuzzyWordCount test error message [06d28a46](https://github.com/gohugoio/hugo/commit/06d28a464d086880f52dd850f91e668ab957b31f) [@GregorioMartinez](https://github.com/GregorioMartinez)

+### Other

+* Fix archetype handling of directories in theme [78578632](https://github.com/gohugoio/hugo/commit/78578632f545283741a01f024a6ccedc0b695a30) [@bep](https://github.com/bep) [#5318](https://github.com/gohugoio/hugo/issues/5318)

+* Simple doc fix in CONTRIBUTING.md [3a308912](https://github.com/gohugoio/hugo/commit/3a3089121b852332b5744d1f566959c8cf93cef4) [@krisbudhram](https://github.com/krisbudhram)

+* Fix type checking in Append [2159d77f](https://github.com/gohugoio/hugo/commit/2159d77f368eb1f78e51dd94133554f88052d85f) [@bep](https://github.com/bep) [#5303](https://github.com/gohugoio/hugo/issues/5303)

+* Fix go plugin build failure by renaming go.mod [3033a9a3](https://github.com/gohugoio/hugo/commit/3033a9a37eb66c08e60f9fe977f29d22bd646857) [@anthonyfok](https://github.com/anthonyfok)

binary files /dev/null b/content/en/news/0.51-relnotes/featured-hugo-51-poster.png differ

--- /dev/null

+++ b/content/en/news/0.51-relnotes/index.md

@@ -1,0 +1,102 @@

+---

+date: 2018-11-07

+title: "Hugo 0.51: The 30K Stars Edition!"

+description: "Bug fixes, new template functions and more error improvements."

+categories: ["Releases"]

+---

+Hugo reached [30 000 stars on GitHub](https://github.com/gohugoio/hugo/stargazers) this week, which is a good occasion to do a follow-up release of the great Hugo `0.50`. This is mostly a bug fix release, but it also adds some useful new functionality, two examples are the new template funcs [complement](https://gohugo.io/functions/complement/) and [symdiff](https://gohugo.io/functions/symdiff/). This release also continues the work on improving Hugo's error messages. And with `.Position` now available on shortcodes, you can also improve your own error messages inside your custom shortcodes:

+```bash

+{{ with .Get "name" }}

+{{ else }}

+{{ errorf "missing value for param 'name': %s" .Position }}

+{{ end }}

+```

+When the above fails, you will see an `ERROR` log similar to the below:

+```bash

+ERROR 2018/11/07 10:05:55 missing value for param name: "/sites/hugoDocs/content/en/variables/shortcodes.md:32:1"

+```

+This release represents **31 contributions by 5 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 [@krisbudhram](https://github.com/krisbudhram), [@LorenzCK](https://github.com/LorenzCK), and [@coliff](https://github.com/coliff) for their ongoing contributions.

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

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

+which has received **6 contributions by 5 contributors**. A special thanks to [@ikemo3](https://github.com/ikemo3), [@maiki](https://github.com/maiki), [@morya](https://github.com/morya), and [@regisphilibert](https://github.com/regisphilibert) for their work on the documentation site.

+Hugo now has:

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

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

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

+## Notes

+* Remove deprecated useModTimeAsFallback [0bc4b024](https://github.com/gohugoio/hugo/commit/0bc4b0246dd6b7d71f8676a52644077a4f70ec8f) [@bep](https://github.com/bep)

+* Bump to ERROR for the deprecated Pages.Sort [faeb55c1](https://github.com/gohugoio/hugo/commit/faeb55c1d827f0ea994551a103ff4f7448786d39) [@bep](https://github.com/bep)

+* Deprecate .Site.Ref and .Site.RelRef [6c6a6c87](https://github.com/gohugoio/hugo/commit/6c6a6c87ec2b5ac7342e268ab47861429230f7f4) [@bep](https://github.com/bep) [#5386](https://github.com/gohugoio/hugo/issues/5386)

+## Enhancements

+### Templates

+* Properly handle pointer types in complement/symdiff [79a06aa4](https://github.com/gohugoio/hugo/commit/79a06aa4b64b526c242dfa41f2c7bc24e1352d5b) [@bep](https://github.com/bep)

+* Add collections.SymDiff [488776b6](https://github.com/gohugoio/hugo/commit/488776b6498d1377718133d42daa87ce1236215d) [@bep](https://github.com/bep) [#5410](https://github.com/gohugoio/hugo/issues/5410)

+* Add collections.Complement [42d8dfc8](https://github.com/gohugoio/hugo/commit/42d8dfc8c88af03ea926a59bc2332acc70cca5f6) [@bep](https://github.com/bep) [#5400](https://github.com/gohugoio/hugo/issues/5400)

+### Core

+* Improve error message on duplicate menu items [3a44920e](https://github.com/gohugoio/hugo/commit/3a44920e79ef86003555d8a4860c29257b2914f0) [@bep](https://github.com/bep)

+* Add .Position to shortcode [33a7b36f](https://github.com/gohugoio/hugo/commit/33a7b36fd42ee31dd79115ec6639bed24247332f) [@bep](https://github.com/bep) [#5371](https://github.com/gohugoio/hugo/issues/5371)

+### Other

+* Document shortcode error handling [e456e34b](https://github.com/gohugoio/hugo/commit/e456e34bdbde058243eb0a5d3c0017748639e08e) [@bep](https://github.com/bep)

+* Document symdiff [5d14d04a](https://github.com/gohugoio/hugo/commit/5d14d04ac678ad24e4946ed2a581ab71b3834def) [@bep](https://github.com/bep)

+* Document complement [ddcb4028](https://github.com/gohugoio/hugo/commit/ddcb402859b50193bfd6d8b752b568d26d14f603) [@bep](https://github.com/bep)

+* Update minify [d212f609](https://github.com/gohugoio/hugo/commit/d212f60949b6afefbe5aa79394f98dbddf7be068) [@bep](https://github.com/bep)

+* Re-generate CLI docs [2998fa0c](https://github.com/gohugoio/hugo/commit/2998fa0cd5bad161b9c802d2409d8c9c81155011) [@bep](https://github.com/bep)

+* Add --minify to hugo server [5b1edd28](https://github.com/gohugoio/hugo/commit/5b1edd281a493bdb27af4dc3c8fae7e10dd54830) [@bep](https://github.com/bep)

+* Make WARN the new default log log level [4b7d3e57](https://github.com/gohugoio/hugo/commit/4b7d3e57a40214a1269eda59731aa22a8f4463dd) [@bep](https://github.com/bep) [#5203](https://github.com/gohugoio/hugo/issues/5203)

+* Regenerate the docs helper [486bc46a](https://github.com/gohugoio/hugo/commit/486bc46a5217a9d70fe0d14ab9261d7b4eb026d6) [@bep](https://github.com/bep)

+* Skip watcher event files if matched in ignoreFiles [f8446188](https://github.com/gohugoio/hugo/commit/f8446188dbec8378f34f0fea39161a49fcc46083) [@krisbudhram](https://github.com/krisbudhram)

+* Update Chroma [d523aa4b](https://github.com/gohugoio/hugo/commit/d523aa4bb03e913f55c2f89544e6112e320c975a) [@bep](https://github.com/bep) [#5392](https://github.com/gohugoio/hugo/issues/5392)

+* Add file (line/col) info to ref/relref errors [1d18eb05](https://github.com/gohugoio/hugo/commit/1d18eb0574a57c3e9f468659d076a666a3dd76f2) [@bep](https://github.com/bep) [#5371](https://github.com/gohugoio/hugo/issues/5371)

+* Improve log color regexp [d3a98325](https://github.com/gohugoio/hugo/commit/d3a98325c31d7f02f0762e589a4986e55b2a0da2) [@bep](https://github.com/bep)

+* Correct minor typo (#5372) [e65268f2](https://github.com/gohugoio/hugo/commit/e65268f2c2dd5ac54681d3266564901d99ed3ea3) [@coliff](https://github.com/coliff)

+## Fixes

+### Templates

+* Fix the docshelper [61f210dd](https://github.com/gohugoio/hugo/commit/61f210dd7abe5de77c27dc6a6995a3ad5e77afa1) [@bep](https://github.com/bep)

+* Fix BOM issue in templates [3a786a24](https://github.com/gohugoio/hugo/commit/3a786a248d3eff6e732aa94e87d6e88196e5147a) [@bep](https://github.com/bep) [#4895](https://github.com/gohugoio/hugo/issues/4895)

+### Output

+* Fix ANSI character output regression on Windows [b8725f51](https://github.com/gohugoio/hugo/commit/b8725f5181f6a2709274a82c1c3fdfd8f2e3e28c) [@LorenzCK](https://github.com/LorenzCK) [#5377](https://github.com/gohugoio/hugo/issues/5377)

+### Core

+* Fix changing paginators in lazy render [b8b8436f](https://github.com/gohugoio/hugo/commit/b8b8436fcca17c152e94cae2a1acad32efc3946c) [@bep](https://github.com/bep) [#5406](https://github.com/gohugoio/hugo/issues/5406)

+* Fix REF_NOT_FOUND logging to include page path [6180c85f](https://github.com/gohugoio/hugo/commit/6180c85fb8f95e01446b74c50cab3f0480305fe4) [@bep](https://github.com/bep) [#5371](https://github.com/gohugoio/hugo/issues/5371)

+* Fix broken manual summary handling [b2a676f5](https://github.com/gohugoio/hugo/commit/b2a676f5f09a3eea360887b099b9d5fc25a88492) [@bep](https://github.com/bep) [#5381](https://github.com/gohugoio/hugo/issues/5381)

+* Fix deadlock when content building times out [729593c8](https://github.com/gohugoio/hugo/commit/729593c842794eaf7127050953a5c2256d332051) [@bep](https://github.com/bep) [#5375](https://github.com/gohugoio/hugo/issues/5375)

+### Other

+* Fix spelling [47506d16](https://github.com/gohugoio/hugo/commit/47506d164467eb7ddbcada81b767d8df5f9c8786) [@qeesung](https://github.com/qeesung)

+* Fix shortcode directly following a shortcode delimiter [d16a7a33](https://github.com/gohugoio/hugo/commit/d16a7a33ff1f22b9fa357189a901a4f1de4e65e7) [@bep](https://github.com/bep) [#5402](https://github.com/gohugoio/hugo/issues/5402)

+* Fix recently broken error template [2bd9d909](https://github.com/gohugoio/hugo/commit/2bd9d9099db267831731ed2d2200eb09305df9fc) [@bep](https://github.com/bep)

binary files /dev/null b/content/en/news/0.52-relnotes/featured-hugo-52-poster.png differ

--- /dev/null

+++ b/content/en/news/0.52-relnotes/index.md

@@ -1,0 +1,79 @@

+---

+date: 2018-11-28

+title: "And Now: Hugo 0.52"

+description: "Configurable file caches, inline shortcodes, and more ..."

+categories: ["Releases"]

+---

+The two big new items in this release is [Inline Shortcodes](https://gohugo.io//templates/shortcode-templates/#inline-shortcodes) and [Consolidated File Caches](https://gohugo.io/getting-started/configuration/#configure-file-caches). In Hugo we really care about build speed, and caching is important. With this release, you get much better control over your cache configuration, which is especially useful when building on a Continous Integration server (Netlify, CircleCI or similar). Inline Shortcodes was implemented to help the Bootstrap project [move their documentation site](https://github.com/twbs/bootstrap/issues/24475#issuecomment-441238128) to Hugo. Note that this feature is disabled by default. To enable, set `enableInlineShortcodes = true` in your site config. Worth mentioning is also the new `param` shortcode, which looks up the param in page front matter with the site's parameter as a fall back.

+This release represents **33 contributions by 7 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), [@emirb](https://github.com/emirb), and [@allizad](https://github.com/allizad) for their ongoing contributions.

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

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

+which has received **10 contributions by 4 contributors**. A special thanks to [@budparr](https://github.com/budparr), [@bep](https://github.com/bep), [@allizad](https://github.com/allizad), and [@funkydan2](https://github.com/funkydan2) for their work on the documentation site.

+Hugo now has:

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

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

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

+## Enhancements

+### Templates

+* Add tests [ed698e94](https://github.com/gohugoio/hugo/commit/ed698e94c12c05bfc392eaca4f0c8442eac64906) [@moorereason](https://github.com/moorereason)

+* Regenerate templates [89e2716d](https://github.com/gohugoio/hugo/commit/89e2716d290708ccde0a6f65504c1650c2f41b3d) [@bep](https://github.com/bep)

+* Add "param" shortcode [f37c5a25](https://github.com/gohugoio/hugo/commit/f37c5a25676db89c0e804ccaac69bb392758192b) [@bep](https://github.com/bep) [#4010](https://github.com/gohugoio/hugo/issues/4010)

+* Add float64 support to where [112461fd](https://github.com/gohugoio/hugo/commit/112461fded0d7970817ce7bf476c4763922ad314) [@moorereason](https://github.com/moorereason) [#5466](https://github.com/gohugoio/hugo/issues/5466)

+### Core

+* Fall back to title in ByLinkTitle sort [a9a93d08](https://github.com/gohugoio/hugo/commit/a9a93d082d8640684b7fd0076c64ea808ea7f762) [@bep](https://github.com/bep) [#4953](https://github.com/gohugoio/hugo/issues/4953)

+* Improve nil handling in IsDescendant and IsAncestor [b09a4033](https://github.com/gohugoio/hugo/commit/b09a40333f382cc1034d2eda856230258ab6b8cc) [@bep](https://github.com/bep) [#5461](https://github.com/gohugoio/hugo/issues/5461)

+### Other

+* Remove duplicate mapstructure depdendency [7e75aeca](https://github.com/gohugoio/hugo/commit/7e75aeca80aead50d64902d2ff47e4ad4d013352) [@bep](https://github.com/bep)

+* Add dependency list to README [e14e0b19](https://github.com/gohugoio/hugo/commit/e14e0b192f39812e3c3d5202d34ee907021412bb) [@bep](https://github.com/bep)

+* Document inline shortcodes [aded0f25](https://github.com/gohugoio/hugo/commit/aded0f25fd23a78804b10e127aebe0e4b6fed2ac) [@bep](https://github.com/bep) [#4011](https://github.com/gohugoio/hugo/issues/4011)

+* Add inline shortcode support [bc337e6a](https://github.com/gohugoio/hugo/commit/bc337e6ab5a75f1f1bfe3a83f3786d0afdb6346c) [@bep](https://github.com/bep) [#4011](https://github.com/gohugoio/hugo/issues/4011)

+* Include drafts in convert command [dcfeed35](https://github.com/gohugoio/hugo/commit/dcfeed35c6e14c1ce593d23be9d2b89c66ce9bee) [@bep](https://github.com/bep) [#5457](https://github.com/gohugoio/hugo/issues/5457)

+* Handle themes in the new file cache (for images, assets) [f9b4eb4f](https://github.com/gohugoio/hugo/commit/f9b4eb4f3968d32f45e0168c854e6b0c7f3a90b0) [@bep](https://github.com/bep) [#5460](https://github.com/gohugoio/hugo/issues/5460)

+* Add tests for permalink on Resource with baseURL with path [12742bac](https://github.com/gohugoio/hugo/commit/12742bac71c65d65dc56548b643debda94757aee) [@bep](https://github.com/bep) [#5226](https://github.com/gohugoio/hugo/issues/5226)

+* Add a comment about file mode for new files [fabf026f](https://github.com/gohugoio/hugo/commit/fabf026f4937bf6fbbb944aa7d6e721839ae4c92) [@bep](https://github.com/bep) [#5434](https://github.com/gohugoio/hugo/issues/5434)

+* Add a :project placeholder [94f0f7e5](https://github.com/gohugoio/hugo/commit/94f0f7e59788e802e706a55cac0d52a9e70ff745) [@bep](https://github.com/bep) [#5439](https://github.com/gohugoio/hugo/issues/5439)

+* Add a cache prune func [3c29c5af](https://github.com/gohugoio/hugo/commit/3c29c5af8ee865ef20741f576088e031e940c3d2) [@bep](https://github.com/bep) [#5439](https://github.com/gohugoio/hugo/issues/5439)

+* Add a filecache root dir [33502667](https://github.com/gohugoio/hugo/commit/33502667fbacf57167ede66df8f13e308a4a9aec) [@bep](https://github.com/bep)

+* Use time.Duration for maxAge [d3489eba](https://github.com/gohugoio/hugo/commit/d3489eba5dfc0ecdc032016d9db0746213dd5f0e) [@bep](https://github.com/bep) [#5438](https://github.com/gohugoio/hugo/issues/5438)

+* Split implementation and config into separate files [17d7ecde](https://github.com/gohugoio/hugo/commit/17d7ecde2b261d2ab29049d12361b66504e3f995) [@bep](https://github.com/bep)

+* Update to LibSASS 3.5.5 [e4b25728](https://github.com/gohugoio/hugo/commit/e4b2572880550a997d51dab3b198dac1fd642690) [@bep](https://github.com/bep) [#5432](https://github.com/gohugoio/hugo/issues/5432)[#5435](https://github.com/gohugoio/hugo/issues/5435)

+* More spelling corrections [782dd158](https://github.com/gohugoio/hugo/commit/782dd15858128d8dfe78970c86e543b6590a004c) [@bep](https://github.com/bep)

+* Spelling corrections [aff9c091](https://github.com/gohugoio/hugo/commit/aff9c091669a022b59f493c9dccf72be29511299) [@bep](https://github.com/bep)

+* Remove appveyor [fdd4a768](https://github.com/gohugoio/hugo/commit/fdd4a768f053b21271d4520bf0d43baf62d516da) [@bep](https://github.com/bep)

+* Document the new file cache [abeeff13](https://github.com/gohugoio/hugo/commit/abeeff1325267f8d8f1f66f0ec4ed175ffc140ad) [@bep](https://github.com/bep) [#5404](https://github.com/gohugoio/hugo/issues/5404)

+* Add a consolidated file cache [f7aeaa61](https://github.com/gohugoio/hugo/commit/f7aeaa61291dd75f92901bcbeecc7fce07a28dec) [@bep](https://github.com/bep) [#5404](https://github.com/gohugoio/hugo/issues/5404)

+* Add Windows build config to Travis [7d78a2af](https://github.com/gohugoio/hugo/commit/7d78a2afd3c4a6c4af77a4ddcbd2a82f15986048) [@emirb](https://github.com/emirb)

+* Add Elasticsearch/bonsai.io to services doc. [c0b3a1af](https://github.com/gohugoio/hugo/commit/c0b3a1af0354e3aa9979cc00ae8630d7f0be63dc) [@allizad](https://github.com/allizad)

+## Fixes

+### Templates

+* Fix whitespace issue [aba2647c](https://github.com/gohugoio/hugo/commit/aba2647c152ffff927f42523b77ee6651630cd67) [@max-arnold](https://github.com/max-arnold)

+* Fix test to pass with gccgo [a8cb1b07](https://github.com/gohugoio/hugo/commit/a8cb1b07b4cf7fcf0e949657cb03c1a4838f975e) [@ianlancetaylor](https://github.com/ianlancetaylor)

+### Other

+* Fix handling of commented out front matter [7540a628](https://github.com/gohugoio/hugo/commit/7540a62834d4465af8936967e430a9e05a1e1359) [@bep](https://github.com/bep) [#5478](https://github.com/gohugoio/hugo/issues/5478)

+* Fix when only shortcode and then summary [94ab125b](https://github.com/gohugoio/hugo/commit/94ab125b27a29a65e5ea45efd99dd247084b4c37) [@bep](https://github.com/bep) [#5464](https://github.com/gohugoio/hugo/issues/5464)

+* Fix ignored --config flag with 'new' command [e82b2dc8](https://github.com/gohugoio/hugo/commit/e82b2dc8c1628f2da33e5fb0bae1b03e0594ad2c) [@krisbudhram](https://github.com/krisbudhram)

+* Fix Permalink for resource, baseURL with path and canonifyURLs set [5df2b79d](https://github.com/gohugoio/hugo/commit/5df2b79dd2734e9a00ed1692328f58c385676468) [@bep](https://github.com/bep) [#5226](https://github.com/gohugoio/hugo/issues/5226)

--- a/content/en/templates/files.md

+++ b/content/en/templates/files.md

@@ -48,7 +48,7 @@

 The above shortcode [is part of the code for the Hugo docs][dirindex]. Here it lists this site's CSS files:

-{{< directoryindex path="/themes/gohugoioTheme/static/dist" pathURL="/css" >}}

+{{< directoryindex path="/themes/gohugoioTheme/static" pathURL="/css" >}}

 {{% note "Slashes are Im