Squashed 'docs/' changes from 50c02516c..0c3c04fd6

0c3c04fd6 Merge pull request #827 from BCNelson/range-patch
b14dd3505 Updated link to Go Docs to more helpful page
c3d83149a Boolean Values in the Where Function
56d4cea3c hugo-extended no longer the default
e9b15c698 Update index.md
11de98e0d Release 0.55.6
d2def17f4 Merge branch 'release-0.55.6'
115457b70 releaser: Add release notes to /docs for release of 0.55.6
25855690d Fix misspelling
fc5e43db2 Update 404.md with Netlify Instructions
9f684318f Removed mentioning of removed --stepAnalysis command line option
86ba9071c Related md5 and aliases for sha1/sha256
15f48966a Added related sha function into the See Also
5e08b6930 Fix date description
908e87ab2 Revert docs/config.toml changes
c925646cf Add a "deploy" command
e765084dd Update sectionvars.md
e08be4d81 Update sectionvars.md
7c9653cbe Hugo 0.55.5
1035ff028 releaser: Add release notes to /docs for release of 0.55.5
cda21f9d4 docs: Regenerate docs helper

git-subtree-dir: docs
git-subtree-split: 0c3c04fd63a7f140bdca0d3ca9b1e9dc794ebd77

diff --git a/content/en/content-management/front-matter.md b/content/en/content-management/front-matter.md
index 4a52b160c36d5e9b36fffb07a72f94edb3410e97..4ff37400097f44d5e4f487c26ced09538de53d8f 100644 (file)
--- a/content/en/content-management/front-matter.md
+++ b/content/en/content-management/front-matter.md
@@ -61,7 +61,7 @@ audio
 : an array of paths to audio files related to the page; used by the `opengraph` [internal template](/templates/internal) to populate `og:audio`.
 
 date
-: the datetime at which the content was created; note this value is auto-populated according to Hugo's built-in [archetype][].
+: the datetime assigned to this page. This is usually fetched from the `date` field in front matter, but this behaviour is configurable.
 
 description
 : the description for the content.

diff --git a/content/en/functions/md5.md b/content/en/functions/md5.md
index 31197f21819ac73d7f4e665a0723f7a24f12d129..db5442166f48610fdf755b7a540c0cb6b9b7359c 100644 (file)
--- a/content/en/functions/md5.md
+++ b/content/en/functions/md5.md
@@ -14,7 +14,7 @@ keywords: []
 signature: ["md5 INPUT"]
 workson: []
 hugoversion:
-relatedfuncs: []
+relatedfuncs: [sha]
 deprecated: false
 aliases: []
 ---

diff --git a/content/en/functions/sha.md b/content/en/functions/sha.md
index 4e12434690398504fb583db6ee013355b45f4897..d10da3446dc00c93ac23bc2bd6dc523d73ce60cf 100644 (file)
--- a/content/en/functions/sha.md
+++ b/content/en/functions/sha.md
@@ -14,9 +14,9 @@ keywords: [sha,checksum]
 signature: ["sha1 INPUT", "sha256 INPUT"]
 workson: []
 hugoversion:
-relatedfuncs: []
+relatedfuncs: [md5]
 deprecated: false
-aliases: []
+aliases: [sha1, sha256]
 ---
 
 `sha1` hashes the given input and returns its SHA1 checksum.

diff --git a/content/en/functions/where.md b/content/en/functions/where.md
index 29623c908764af013688539222848c6d5e4ab686..ece4acb215f46259bbe68c9a21ba5044c4f72e8e 100644 (file)
--- a/content/en/functions/where.md
+++ b/content/en/functions/where.md
@@ -83,6 +83,15 @@ The following logical operators are available with `where`:
 `intersect`
 : `true` if a given field value that is a slice/array of strings or integers contains elements in common with the matching value; it follows the same rules as the [`intersect` function][intersect].
 
+## Use `where` with `Booleans`
+When using booleans you should not put quotation marks.
+```go-html-template
+{{range where .Pages ".Draft" true}}
+        <p>{{.Title}}</p>
+{{end}}
+```
+  
+
 ## Use `where` with `intersect`
 
 ```go-html-template
@@ -122,7 +131,7 @@ then ranges through only the first 5 posts in that list:
 You can also nest `where` clauses to drill down on lists of content by more than one parameter. The following first grabs all pages in the "blog" section and then ranges through the result of the first `where` clause and finds all pages that are *not* featured:
 
 ```go-html-template
-{{ range where (where .Pages "Section" "blog" ) ".Params.featured" "!=" "true" }}
+{{ range where (where .Pages "Section" "blog" ) ".Params.featured" "!=" true }}
 ```
 
 ## Unset Fields

diff --git a/content/en/getting-started/configuration.md b/content/en/getting-started/configuration.md
index 4f0a4c8c500ac96a0cdcc12d142dcd0385e9e694..6fbfd37793c487a11d6a03ec943c47d2636c389a 100644 (file)
--- a/content/en/getting-started/configuration.md
+++ b/content/en/getting-started/configuration.md
@@ -247,9 +247,6 @@ sitemap
 staticDir ("static")
 : A directory or a list of directories from where Hugo reads [static files][static-files].
 
-stepAnalysis (false)
-: Display memory and timing of different steps of the program.
-
 summaryLength (70)
 : The length of text in words to show in a [`.Summary`](/content-management/summaries/#hugo-defined-automatic-summary-splitting).
 

diff --git a/content/en/news/0.55.3-relnotes/index.md b/content/en/news/0.55.3-relnotes/index.md
index ee6163a2f1ca15911f4fa283195167e392152acd..d00c47d54ae96e7d95b60cfc7086bcb2e623d705 100644 (file)
--- a/content/en/news/0.55.3-relnotes/index.md
+++ b/content/en/news/0.55.3-relnotes/index.md
@@ -2,7 +2,7 @@
 ---
 date: 2019-04-20
 title: "Hugo 0.55.3: A Few More Bug Fixes!"
-description: "To wrap up this Eeaster, here is one more patch release with some important fixes."
+description: "To wrap up this Easter, here is one more patch release with some important fixes."
 categories: ["Releases"]
 images:
 - images/blog/hugo-bug-poster.png

diff --git a/content/en/news/0.55.5-relnotes/index.md b/content/en/news/0.55.5-relnotes/index.md
new file mode 100644 (file)
index 0000000..45a3eda
--- /dev/null
+++ b/content/en/news/0.55.5-relnotes/index.md
@@ -0,0 +1,56 @@
+
+---
+date: 2019-05-02
+title: "Hugo 0.55.5: Take Five!"
+description: "We round up this 0.55 release with a final batch of bug fixes!"
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+       
+
+This is a bug-fix release with a couple of important fixes.
+
+
+Hugo now has:
+
+* 34743+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 439+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 314+ [themes](http://themes.gohugo.io/)
+
+## Enhancements
+
+### Templates
+
+* Provide more detailed errors in Where [f76e5011](https://github.com/gohugoio/hugo/commit/f76e50118b8b5dd8989d068db35222bfa0a242d8) [@moorereason](https://github.com/moorereason) 
+
+### Other
+
+* Regenerate docs helper [cee181c3](https://github.com/gohugoio/hugo/commit/cee181c3a67fe04b8e0c9f2807c5aa2871df474e) [@bep](https://github.com/bep) 
+* Update blackfriday to v1.5.2 [1cbb501b](https://github.com/gohugoio/hugo/commit/1cbb501be8aa83b08865fbb6ad5aee254946712f) [@dbirks](https://github.com/dbirks) 
+
+## Fixes
+
+### Templates
+
+* Fix nil compare in eq/ne for interface values [66b143a0](https://github.com/gohugoio/hugo/commit/66b143a01d1c192619839b732ce188923ab15d60) [@bep](https://github.com/bep) [#5905](https://github.com/gohugoio/hugo/issues/5905)
+* Fix hugo package name and add godocs [4f93f8c6](https://github.com/gohugoio/hugo/commit/4f93f8c670b26258dc7e3a613c38dbc86d8eda76) [@moorereason](https://github.com/moorereason) 
+
+### Output
+
+* Fix permalink in sitemap etc. when multiple permalinkable output formats [6b76841b](https://github.com/gohugoio/hugo/commit/6b76841b052b97625b8995f326d758b89f5c2349) [@bep](https://github.com/bep) [#5910](https://github.com/gohugoio/hugo/issues/5910)
+
+### Core
+
+* Fix PrevInSection/NextInSection for nested sections [bcbed4eb](https://github.com/gohugoio/hugo/commit/bcbed4ebdaf55b67abc521d69bba456c041a7e7d) [@bep](https://github.com/bep) [#5883](https://github.com/gohugoio/hugo/issues/5883)
+
+### Other
+
+* Fix concurrent initialization order [009076e5](https://github.com/gohugoio/hugo/commit/009076e5ee88fc46c95a9afd34f82f9386aa282a) [@bep](https://github.com/bep) [#5901](https://github.com/gohugoio/hugo/issues/5901)
+
+
+
+
+

diff --git a/content/en/news/0.55.6-relnotes/index.md b/content/en/news/0.55.6-relnotes/index.md
new file mode 100644 (file)
index 0000000..c447aa0
--- /dev/null
+++ b/content/en/news/0.55.6-relnotes/index.md
@@ -0,0 +1,13 @@
+
+---
+date: 2019-05-18
+title: "Hugo 0.55.6: One Bug Fix!"
+description: "Fixes some reported paginator crashes in server mode."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+This is a bug-fix release with one important fix. There have been reports about infrequent paginator crashes when running the Hugo server since 0.55.0. The reason have been narrowed down to that of parallel rebuilds. This isn't a new thing, but the changes in 0.55.0 made it extra important to serialize the page initialization. This release fixes that by protecting the `Build` method with a lock when running in server mode. [95ce2a40](https://github.com/gohugoio/hugo/commit/95ce2a40e734bb82b69f9a64270faf3ed69c92cc) [@bep](https://github.com/bep) [#5885](https://github.com/gohugoio/hugo/issues/5885)[#5968](https://github.com/gohugoio/hugo/issues/5968)
+

diff --git a/content/en/readfiles/sectionvars.md b/content/en/readfiles/sectionvars.md
index 1b97a12d62ee73bc54c8cbb4ae574e0a12a58772..698955c023bef0f301d4486f50e3e6e79ff5ccd4 100644 (file)
--- a/content/en/readfiles/sectionvars.md
+++ b/content/en/readfiles/sectionvars.md
@@ -1,6 +1,9 @@
 .CurrentSection
 : The page's current section. The value can be the page itself if it is a section or the homepage.
 
+.FirstSection
+: The page's first section below root, e.g. `/docs`, `/blog` etc.
+
 .InSection $anotherPage
 : Whether the given page is in the current section. Note that this will always return false for pages that are not either regular, home or section pages.
 

diff --git a/content/en/templates/404.md b/content/en/templates/404.md
index c6bea1912aa28b24a95951e3b326d4b064ee4ee8..bb1d5e42415218b15571ca0e623dbf7c8b13d00d 100644 (file)
--- a/content/en/templates/404.md
+++ b/content/en/templates/404.md
@@ -52,6 +52,7 @@ Your 404.html file can be set to load automatically when a visitor enters a mist
 * Amazon AWS S3. When setting a bucket up for static web serving, you can specify the error file from within the S3 GUI.
 * Amazon CloudFont. You can specify the page in the Error Pages section in the CloudFont Console. [Details here](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html)
 * Caddy Server. Using `errors { 404 /404.html }`. [Details here](https://caddyserver.com/docs/errors)
+* Netlify. Add `/* /404.html 404` to `content/_redirects`. [Details Here](https://www.netlify.com/docs/redirects/#custom-404)
 
 {{% note %}}
 `hugo server` will not automatically load your custom `404.html` file, but you

diff --git a/content/en/templates/introduction.md b/content/en/templates/introduction.md
index 1e1778eb018a45ce84bf9d7c2f94b15fa5ea11a4..02a580e79b1add8e50b455778950ca566ff20996 100644 (file)
--- a/content/en/templates/introduction.md
+++ b/content/en/templates/introduction.md
@@ -20,7 +20,7 @@ toc: true
 ---
 
 {{% note %}}
-The following is only a primer on Go Templates. For an in-depth look into Go Templates, check the official [Go docs](http://golang.org/pkg/html/template/).
+The following is only a primer on Go Templates. For an in-depth look into Go Templates, check the official [Go docs](https://golang.org/pkg/text/template/).
 {{% /note %}}
 
 Go Templates provide an extremely simple template language that adheres to the belief that only the most basic of logic belongs in the template or view layer.
@@ -233,6 +233,18 @@ key.
 {{ end }}
 ```
 
+#### Example 5: Conditional on empty _map_, _array_, or _slice_.
+
+If the _map_, _array_, or _slice_ passed into the range is zero-length then the else statment is evaluated.
+
+```go-html-template
+{{ range $array }}
+    {{ . }}
+{{else}}
+    <!-- This is only evaluated if $array is empty -->
+{{ end }}
+```
+
 ### Conditionals
 
 `if`, `else`, `with`, `or`, and `and` provide the framework for handling conditional logic in Go Templates. Like `range`, each statement is closed with an `{{ end }}`.

diff --git a/content/en/troubleshooting/build-performance.md b/content/en/troubleshooting/build-performance.md
index bc75ce262fad6f50cc2db5de4f80a682ba927727..e0700f381aae528d96bf964fcbdee6868dffa718 100644 (file)
--- a/content/en/troubleshooting/build-performance.md
+++ b/content/en/troubleshooting/build-performance.md
@@ -98,14 +98,4 @@ parameters to `partialCached` beyond the initial context.  See the
 {{% /tip %}}
 
 
-## Step Analysis
-
-Hugo provides a means of seeing metrics about each step in the site build
-process.  We call that *Step Analysis*.  The *step analysis* output shows the
-total time per step, the cumulative time after each step (in parentheses),
-the memory usage per step, and the total memory allocations per step.
-
-To enable *step analysis*, use the `--stepAnalysis` option when running Hugo.
-
-
 [partialCached]:{{< ref "/functions/partialCached.md" >}}

diff --git a/content/en/troubleshooting/faq.md b/content/en/troubleshooting/faq.md
index 34d42958ca8cbc5799b589847c09b535f78a77d1..c68473a84ddb82be9457e934a579145d9ceaf854 100644 (file)
--- a/content/en/troubleshooting/faq.md
+++ b/content/en/troubleshooting/faq.md
@@ -51,6 +51,6 @@ If you process `SCSS` or `SASS` to `CSS` in your Hugo project, you need the Hugo
 error: failed to transform resource: TOCSS: failed to transform "scss/main.scss" (text/x-scss): this feature is not available in your current Hugo version
 ```
 
-We release two set of binaries for technical reasons. The extended is what you get by default, as an example, when you run `brew install hugo` on `macOS`. On the [release page](https://github.com/gohugoio/hugo/releases), look for archives with `extended` in the name.
+We release two set of binaries for technical reasons. The extended is not what you get by default, as an example, when you run `brew install hugo` on `macOS`. On the [release page](https://github.com/gohugoio/hugo/releases), look for archives with `extended` in the name. To build `hugo-extended`, use `go install --tags extended`
 
 To confirm, run `hugo version` and look for the word `extended`.

diff --git a/data/docs.json b/data/docs.json
index 22f6cad48a59bfa8a93606b1d9bf128202070973..dbed37f775624d97e2e16db230fe118fedfe0fad 100644 (file)
--- a/data/docs.json
+++ b/data/docs.json
@@ -1498,6 +1498,30 @@
   },
   "output": {
     "formats": [
+      {
+        "MediaType": "text/html",
+        "name": "HTML",
+        "mediaType": {
+          "type": "text/html",
+          "string": "text/html",
+          "mainType": "text",
+          "subType": "html",
+          "delimiter": ".",
+          "suffixes": [
+            "html"
+          ]
+        },
+        "path": "",
+        "baseName": "index",
+        "rel": "canonical",
+        "protocol": "",
+        "isPlainText": false,
+        "isHTML": true,
+        "noUgly": false,
+        "notAlternative": false,
+        "permalinkable": true,
+        "weight": 10
+      },
       {
         "MediaType": "text/html",
         "name": "AMP",
@@ -1519,7 +1543,8 @@
         "isHTML": true,
         "noUgly": false,
         "notAlternative": false,
-        "permalinkable": true
+        "permalinkable": true,
+        "weight": 0
       },
       {
         "MediaType": "text/css",
@@ -1542,7 +1567,8 @@
         "isHTML": false,
         "noUgly": false,
         "notAlternative": true,
-        "permalinkable": false
+        "permalinkable": false,
+        "weight": 0
       },
       {
         "MediaType": "text/csv",
@@ -1565,7 +1591,8 @@
         "isHTML": false,
         "noUgly": false,
         "notAlternative": false,
-        "permalinkable": false
+        "permalinkable": false,
+        "weight": 0
       },
       {
         "MediaType": "text/calendar",
@@ -1588,30 +1615,8 @@
         "isHTML": false,
         "noUgly": false,
         "notAlternative": false,
-        "permalinkable": false
-      },
-      {
-        "MediaType": "text/html",
-        "name": "HTML",
-        "mediaType": {
-          "type": "text/html",
-          "string": "text/html",
-          "mainType": "text",
-          "subType": "html",
-          "delimiter": ".",
-          "suffixes": [
-            "html"
-          ]
-        },
-        "path": "",
-        "baseName": "index",
-        "rel": "canonical",
-        "protocol": "",
-        "isPlainText": false,
-        "isHTML": true,
-        "noUgly": false,
-        "notAlternative": false,
-        "permalinkable": true
+        "permalinkable": false,
+        "weight": 0
       },
       {
         "MediaType": "application/json",
@@ -1634,7 +1639,8 @@
         "isHTML": false,
         "noUgly": false,
         "notAlternative": false,
-        "permalinkable": false
+        "permalinkable": false,
+        "weight": 0
       },
       {
         "MediaType": "text/plain",
@@ -1657,7 +1663,8 @@
         "isHTML": false,
         "noUgly": false,
         "notAlternative": false,
-        "permalinkable": false
+        "permalinkable": false,
+        "weight": 0
       },
       {
         "MediaType": "application/rss+xml",
@@ -1680,7 +1687,8 @@
         "isHTML": false,
         "noUgly": true,
         "notAlternative": false,
-        "permalinkable": false
+        "permalinkable": false,
+        "weight": 0
       },
       {
         "MediaType": "application/xml",
@@ -1703,7 +1711,8 @@
         "isHTML": false,
         "noUgly": true,
         "notAlternative": false,
-        "permalinkable": false
+        "permalinkable": false,
+        "weight": 0
       }
     ],
     "layouts": [

diff --git a/netlify.toml b/netlify.toml
index 73e13ac3e2727cb10fa41bdf3a8b6b03f974baad..667456275820d003d7cd2c5ad61b6cd484c6211f 100644 (file)
--- a/netlify.toml
+++ b/netlify.toml
@@ -3,7 +3,7 @@ publish = "public"
 command = "hugo --gc --minify"
 
 [context.production.environment]
-HUGO_VERSION = "0.55.4"
+HUGO_VERSION = "0.55.6"
 HUGO_ENV = "production"
 HUGO_ENABLEGITINFO = "true"
 
@@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
 command = "hugo --gc --minify --enableGitInfo"
 
 [context.split1.environment]
-HUGO_VERSION = "0.55.4"
+HUGO_VERSION = "0.55.6"
 HUGO_ENV = "production"
 
 [context.deploy-preview]
 command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
 
 [context.deploy-preview.environment]
-HUGO_VERSION = "0.55.4"
+HUGO_VERSION = "0.55.6"
 
 [context.branch-deploy]
 command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
 
 [context.branch-deploy.environment]
-HUGO_VERSION = "0.55.4"
+HUGO_VERSION = "0.55.6"
 
 [context.next.environment]
 HUGO_ENABLEGITINFO = "true"