Merge commit '32ba623541d74ee0b7ae4efb1b8326dc49af28b8'

docs/.gitignore

@@ -1,5 +1,6 @@
 /.idea
 /public
+node_modules
 nohup.out
 .DS_Store
 trace.out

docs/content/en/content-management/image-processing/index.md

@@ -167,21 +167,23 @@ For color codes, see https://www.google.com/search?q=color+picker
 
 **Note** that you also set a default background color to use, see [Image Processing Config](#image-processing-config).
 
-### JPEG and Webp Quality
+### JPEG and WebP Quality
 
-Only relevant for JPEG and Webp images, values 1 to 100 inclusive, higher is better. Default is 75.
+Only relevant for JPEG and WebP images, values 1 to 100 inclusive, higher is better. Default is 75.
 
 ```go
 {{ $image.Resize "600x q50" }}
 ```
 
-{{< new-in "0.83.0" >}} Webp support was added in Hugo 0.83.0.
+{{< new-in "0.83.0" >}} WebP support was added in Hugo 0.83.0.
 
 ### Hint
 
  {{< new-in "0.83.0" >}}
 
-Hint about what type of image this is. Currently only used when encoding to Webp.
+ {{< new-in "0.83.0" >}}
+
+Hint about what type of image this is. Currently only used when encoding to WebP.
 
 Default value is `photo`.
 
@@ -227,12 +229,14 @@ See https://github.com/disintegration/imaging for more. If you want to trade qua
 
 By default the images is encoded in the source format, but you can set the target format as an option.
 
-Valid values are `jpg`, `png`, `tif`, `bmp`, and `gif`.
+Valid values are `jpg`, `png`, `tif`, `bmp`, `gif` and `webp`.
 
 ```go
 {{ $image.Resize "600x jpg" }}
 ```
 
+{{< new-in "0.83.0" >}} WebP support was added in Hugo 0.83.0.
+
 ## Image Processing Examples
 
 _The photo of the sunset used in the examples below is Copyright [Bjørn Erik Pedersen](https://commons.wikimedia.org/wiki/User:Bep) (Creative Commons Attribution-Share Alike 4.0 International license)_
@@ -274,10 +278,10 @@ You can configure an `imaging` section in `config.toml` with default image proce
 # See https://github.com/disintegration/imaging
 resampleFilter = "box"
 
-# Default JPEG or WEBP quality setting. Default is 75.
+# Default JPEG or WebP quality setting. Default is 75.
 quality = 75
 
-# Default hint about what type of image. Currently only used for Webp encoding.
+# Default hint about what type of image. Currently only used for WebP encoding.
 # Default is "photo".
 # Valid values are "picture", "photo", "drawing", "icon", or "text".
 hint = "photo"

docs/content/en/functions/scratch.md

@@ -1,6 +1,6 @@
 ---
 title: .Scratch
-description: Acts as a "scratchpad" to allow for writable page- or shortcode-scoped variables.
+description: Acts as a "scratchpad" to store and manipulate data.
 godocref:
 date: 2017-02-01
 publishdate: 2017-02-01
@@ -20,81 +20,98 @@ draft: false
 aliases: [/extras/scratch/,/doc/scratch/]
 ---
 
-In most cases you can do okay without `Scratch`, but due to scoping issues, there are many use cases that aren't solvable in Go Templates without `Scratch`'s help.
-
-`.Scratch` is available as methods on `Page` and `Shortcode`. Since Hugo 0.43 you can also create a locally scoped `Scratch` using the template func `newScratch`.
-
+Scratch is a Hugo feature designed to conveniently manipulate data in a Go Template world. It is either a Page or Shortcode method for which the resulting data will be attached to the given context, or it can live as a unique instance stored in a variable.
 
 {{% note %}}
-See [this Go issue](https://github.com/golang/go/issues/10608) for the main motivation behind Scratch.
+Note that Scratch was initially created as a workaround for a [Go template scoping limitation](https://github.com/golang/go/issues/10608) that affected Hugo versions prior to 0.48. For a detailed analysis of `.Scratch` and contextual use cases, see [this blog post](https://regisphilibert.com/blog/2017/04/hugo-scratch-explained-variable/).
 {{% /note %}}
 
-{{% note %}}
-For a detailed analysis of `.Scratch` and in context use cases, see this [post](https://regisphilibert.com/blog/2017/04/hugo-scratch-explained-variable/).
-{{% /note %}}
+### Contexted `.Scratch` vs. local `newScratch`
 
-## Get a Scratch
+Since Hugo 0.43, there are two different ways of using Scratch:
 
-From Hugo `0.43` you can also create a locally scoped `Scratch` by calling `newScratch`:
+#### The Page's `.Scratch`
+
+`.Scratch` is available as a Page method or a Shortcode method and attaches the "scratched" data to the given page. Either a Page or a Shortcode context is required to use `.Scratch`.
 
 ```go-html-template
-$scratch := newScratch
-$scratch.Set "greeting" "Hello"
+{{ .Scratch.Set "greeting" "bonjour" }}
+{{ range .Pages }}
+  {{ .Scratch.Set "greeting" (print "bonjour" .Title) }}
+{{ end }}
 ```
 
-A `Scratch` is also added to both `Page` and `Shortcode`. `Scratch` has the following methods:
+#### The local `newScratch`
+
+{{< new-in "0.43.0" >}} A Scratch instance can also be assigned to any variable using the `newScratch` function. In this case, no Page or Shortcode context is required and the scope of the scratch is only local. The methods detailed below are available from the variable the Scratch instance was assigned to.
+
+```go-html-template
+{{ $data := newScratch }}
+{{ $data.Set "greeting" "hola" }}
+```
+
+### Methods
+
+A Scratch has the following methods:
+
+{{% note %}}
+Note that the following examples assume a [local Scratch instance](#the-local-newscratch) has been stored in `$scratch`.
+{{% /note %}}
 
 #### .Set
 
-Set the given value to a given key
+Set the value of a given key.
 
 ```go-html-template
-{{ .Scratch.Set "greeting" "Hello" }}
+{{ $scratch.Set "greeting" "Hello" }}
 ```
+
 #### .Get
-Get the value of a given key
+
+Get the value of a given key.
 
 ```go-html-template
-{{ .Scratch.Set "greeting" "Hello" }}
+{{ $scratch.Set "greeting" "Hello" }}
 ----
-{{ .Scratch.Get "greeting" }} > Hello
+{{ $scratch.Get "greeting" }} > Hello
 ```
 
 #### .Add
-Will add a given value to existing value of the given key. 
+
+Add a given value to existing value(s) of the given key. 
 
 For single values, `Add` accepts values that support Go's `+` operator. If the first `Add` for a key is an array or slice, the following adds will be appended to that list.
 
 ```go-html-template
-{{ .Scratch.Add "greetings" "Hello" }}
-{{ .Scratch.Add "greetings" "Welcome" }}
+{{ $scratch.Add "greetings" "Hello" }}
+{{ $scratch.Add "greetings" "Welcome" }}
 ----
-{{ .Scratch.Get "greetings" }} > HelloWelcome
+{{ $scratch.Get "greetings" }} > HelloWelcome
 ```
 
 ```go-html-template
-{{ .Scratch.Add "total" 3 }}
-{{ .Scratch.Add "total" 7 }}
+{{ $scratch.Add "total" 3 }}
+{{ $scratch.Add "total" 7 }}
 ----
-{{ .Scratch.Get "total" }} > 10
+{{ $scratch.Get "total" }} > 10
 ```
 
-
 ```go-html-template
-{{ .Scratch.Add "greetings" (slice "Hello") }}
-{{ .Scratch.Add "greetings" (slice "Welcome" "Cheers") }}
+{{ $scratch.Add "greetings" (slice "Hello") }}
+{{ $scratch.Add "greetings" (slice "Welcome" "Cheers") }}
 ----
-{{ .Scratch.Get "greetings" }} > []interface {}{"Hello", "Welcome", "Cheers"}
+{{ $scratch.Get "greetings" }} > []interface {}{"Hello", "Welcome", "Cheers"}
 ```
 
 #### .SetInMap
-Takes a `key`, `mapKey` and `value` and add a map of `mapKey` and `value` to the given `key`.
+
+Takes a `key`, `mapKey` and `value` and adds a map of `mapKey` and `value` to the given `key`.
 
 ```go-html-template
-{{ .Scratch.SetInMap "greetings" "english" "Hello" }}
-{{ .Scratch.SetInMap "greetings" "french" "Bonjour" }}
+{{ $scratch.SetInMap "greetings" "english" "Hello" }}
+{{ $scratch.SetInMap "greetings" "french" "Bonjour" }}
 ----
-{{ .Scratch.Get "greetings" }} > map[french:Bonjour english:Hello]
+{{ $scratch.Get "greetings" }} > map[french:Bonjour english:Hello]
 ```
 
 #### .DeleteInMap
@@ -110,32 +127,29 @@ Takes a `key` and `mapKey` and removes the map of `mapKey` from the given `key`.
 ```
 
 #### .GetSortedMapValues
-Returns array of values from `key` sorted by `mapKey`
+
+Return an array of values from `key` sorted by `mapKey`.
 
 ```go-html-template
-{{ .Scratch.SetInMap "greetings" "english" "Hello" }}
-{{ .Scratch.SetInMap "greetings" "french" "Bonjour" }}
+{{ $scratch.SetInMap "greetings" "english" "Hello" }}
+{{ $scratch.SetInMap "greetings" "french" "Bonjour" }}
 ----
-{{ .Scratch.GetSortedMapValues "greetings" }} > [Hello Bonjour]
+{{ $scratch.GetSortedMapValues "greetings" }} > [Hello Bonjour]
 ```
+
 #### .Delete
-Removes the given key
+
+{{< new-in "0.38.0" >}} Remove the given key.
 
 ```go-html-template
-{{ .Scratch.Delete "greetings" }}
+{{ $scratch.Set "greeting" "Hello" }}
+----
+{{ $scratch.Delete "greeting" }}
 ```
 
 #### .Values
 
-`Values` returns the raw backing map. Note that you should just use this method on the locally scoped `Scratch` instances you obtain via `newScratch`, not
- `.Page.Scratch` etc., as that will lead to concurrency issues.
-
-## Scope
-The scope of the backing data is global for the given `Page` or `Shortcode`, and spans partial and shortcode includes.
-
-Note that `.Scratch` from a shortcode will return the shortcode's `Scratch`, which in most cases is what you want. If you want to store it in the page scoped Scratch, then use `.Page.Scratch`.
-
-
+Return the raw backing map. Note that you should only use this method on the locally scoped Scratch instances you obtain via [`newScratch`](#the-local-newscratch), not `.Page.Scratch` etc., as that will lead to concurrency issues.
 
 
 [pagevars]: /variables/page/

docs/content/en/getting-started/usage.md

@@ -167,6 +167,11 @@ Most Hugo builds are so fast that you may not notice the change unless looking d
 Hugo injects the LiveReload `<script>` before the closing `</body>` in your templates and will therefore not work if this tag is not present..
 {{% /note %}}
 
+### Redirect automatically to the page you just saved
+
+When you are working with more than one document and want to see the markup as real-time as possible it's not ideal to keep jumping between them. 
+Fortunately Hugo has an easy, embedded and simple solution for this. It's the flag `--navigateToChanged`.
+
 ### Disable LiveReload
 
 LiveReload works by injecting JavaScript into the pages Hugo generates. The script creates a connection from the browser's web socket client to the Hugo web socket server.

docs/content/en/hosting-and-deployment/hosting-on-github.md

@@ -17,7 +17,7 @@ toc: true
 aliases: [/tutorials/github-pages-blog/]
 ---
 
-GitHub provides free and fast static hosting over SSL for personal, organization, or project pages directly from a GitHub repository via its [GitHub Pages service][] and automate development workflows and build with [GitHub Actions].
+GitHub provides free and fast static hosting over SSL for personal, organization, or project pages directly from a GitHub repository via its [GitHub Pages service][] and automating development workflows and build with [GitHub Actions].
 
 ## Assumptions
 
@@ -45,9 +45,9 @@ This is a much simpler setup as your Hugo files and generated content are publis
 
 ## Build Hugo With GitHub Action
 
-GitHub execute your software development workflows. Everytime you push your code on the Github repository, Github Action will build the site automatically.
+GitHub executes your software development workflows. Everytime you push your code on the Github repository, Github Actions will build the site automatically.
 
-Create a file in `.github/workflows/gh-pages.yml` containing the following content (based on https://github.com/marketplace/actions/hugo-setup ):
+Create a file in `.github/workflows/gh-pages.yml` containing the following content (based on [actions-hugo](https://github.com/marketplace/actions/hugo-setup)):
 
 ```yml
 name: github pages
@@ -56,10 +56,11 @@ on:
   push:
     branches:
       - main  # Set a branch to deploy
+  pull_request:
 
 jobs:
   deploy:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-20.04
     steps:
       - uses: actions/checkout@v2
         with:
@@ -77,12 +78,13 @@ jobs:
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v3
+        if: github.ref == 'refs/heads/main'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./public
 ```
 
-For more advanced settings https://github.com/marketplace/actions/hugo-setup 
+For more advanced settings [actions-hugo](https://github.com/marketplace/actions/hugo-setup) and [actions-gh-pages](https://github.com/marketplace/actions/github-pages-action).
 
 ## Use a Custom Domain
 

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

@@ -67,14 +67,14 @@ For production:
 
 {{< code file="netlify.toml" codeLang="toml" >}}
 [context.production.environment]
-  HUGO_VERSION = "0.82.1"
+  HUGO_VERSION = "0.83.1"
 {{< /code >}}
 
 For testing:
 
 {{< code file="netlify.toml" codeLang="toml" >}}
 [context.deploy-preview.environment]
-  HUGO_VERSION = "0.82.1"
+  HUGO_VERSION = "0.83.1"
 {{< /code >}}
 
 The Netlify configuration file can be a little hard to understand and get right for the different environment, and you may get some inspiration and tips from this site's `netlify.toml`:

docs/content/en/hosting-and-deployment/hugo-deploy.md

@@ -4,7 +4,7 @@ linktitle: Hugo Deploy
 description: You can upload your site to GCS, S3, or Azure using the Hugo CLI.
 date: 2019-05-30
 publishdate: 2019-05-30
-lastmod: 2019-05-30
+lastmod: 2021-05-03
 categories: [hosting and deployment]
 keywords: [s3,gcs,azure,hosting,deployment]
 authors: [Robert van Gent]
@@ -95,10 +95,13 @@ cloudFrontDistributionID = <ID>
 
 
 # [[deployment.matchers]] configure behavior for files that match the Pattern.
+# See https://golang.org/pkg/regexp/syntax/ for pattern syntax.
+# Pattern searching is stopped on first match.
+
 # Samples:
 
 [[deployment.matchers]]
-#  Cache static assets for 1 year.
+# Cache static assets for 1 year.
 pattern = "^.+\\.(js|css|svg|ttf)$"
 cacheControl = "max-age=31536000, no-transform, public"
 gzip = true
@@ -108,6 +111,12 @@ pattern = "^.+\\.(png|jpg)$"
 cacheControl = "max-age=31536000, no-transform, public"
 gzip = false
 
+[[deployment.matchers]]
+# Set custom content type for /sitemap.xml
+pattern = "^sitemap\\.xml$"
+contentType = "application/xml"
+gzip = true
+
 [[deployment.matchers]]
 pattern = "^.+\\.(html|xml|json)$"
 gzip = true

docs/content/en/hugo-modules/_index.md

@@ -21,7 +21,7 @@ toc: true
 
 You can combine modules in any combination you like, and even mount directories from non-Hugo projects, forming a big, virtual union file system.
 
-Hugo Modules is powered by Go Modules. For more information about Go Modules, see:
+Hugo Modules are powered by Go Modules. For more information about Go Modules, see:
 
 - [https://github.com/golang/go/wiki/Modules](https://github.com/golang/go/wiki/Modules)
 - [https://blog.golang.org/using-go-modules](https://blog.golang.org/using-go-modules)

docs/content/en/news/0.83.0-relnotes/index.md

@@ -1,15 +1,22 @@
 
 ---
 date: 2021-05-01
-title: "0.83.0"
-description: "0.83.0"
+title: "Hugo 0.83: WebP Support!"
+description: "WebP image encoding support, some important i18n fixes, and more."
 categories: ["Releases"]
 ---
 
-	Hugo `0.83` finally brings [WebP](https://gohugo.io/content-management/image-processing/) image processing support. Note that you need the [extended version](https://gohugo.io/troubleshooting/faq/#i-get-tocss--this-feature-is-not-available-in-your-current-hugo-version) of Hugo to encode to WebP. If you want to target all Hugo versions, you may use a construct such as this:
+**Note:** If you use i18n, there is an unfortunate regression bug in this release (see [issue](https://github.com/gohugoio/hugo/issues/8492)). A patch release coming Sunday.
+
+
+Hugo `0.83` finally brings [WebP](https://gohugo.io/content-management/image-processing/) image processing support. Note that you need the [extended version](https://gohugo.io/troubleshooting/faq/#i-get-tocss--this-feature-is-not-available-in-your-current-hugo-version) of Hugo to encode to WebP. If you want to target all Hugo versions, you may use a construct such as this:
 
 ```go-html-template
-FOO
+{{ $images := slice }}
+{{ $images = $images | append ($img.Resize "300x") }}
+{{ if hugo.IsExtended }}
+  {{ $images = $images | append ($img.Resize "300x webp") }}
+{{ end }}
 ```
 
 Also worth highlighting:

docs/content/en/news/0.83.1-relnotes/index.md

@@ -1,8 +1,8 @@
 
 ---
 date: 2021-05-02
-title: "Hugo 0.83.1: A couple of Bug Fixes"
-description: "This version fixes a couple of bugs introduced in 0.83.0."
+title: "Hugo 0.83.1: One Bug Fix"
+description: "This version fixes an issue introduced in 0.83.0."
 categories: ["Releases"]
 images:
 - images/blog/hugo-bug-poster.png

docs/content/en/readfiles/pages-vs-site-pages.md

@@ -27,9 +27,7 @@ the current _list_ page:
     current _list_ page. This **excludes** regular pages in nested sections/_list_ pages (those are subdirectories with an `_index.md` file.
 
 `.RegularPagesRecursive`
-: Collection of **all** _regular_ pages under a _list_ page. This **includes** regular pages in nested sections/_list_ pages.
-
-This feature was added in Hugo version 0.68.0
+: {{< new-in "0.68.0" >}} Collection of **all** _regular_ pages under a _list_ page. This **includes** regular pages in nested sections/_list_ pages.
 
 Note
 : From the scope of _regular_ pages, `.Pages` and

docs/content/en/templates/introduction.md

@@ -68,6 +68,22 @@ Accessing the Page Parameter `bar` defined in a piece of content's [front matter
 {{ if or (isset .Params "alt") (isset .Params "caption") }} Caption {{ end }}
 ```
 
+#### A Single Statement Can be Split over Multiple Lines
+
+```go-html-template
+{{ if or 
+  (isset .Params "alt") 
+  (isset .Params "caption")
+}}
+```
+
+#### Raw String Literals Can Include Newlines
+
+```go-html-template
+{{ $msg := `Line one.
+Line two.` }}
+```
+
 ## Variables {#variables}
 
 Each Go Template gets a data object. In Hugo, each template is passed

docs/content/en/templates/lookup-order.md

@@ -44,7 +44,7 @@ Section
 : Is relevant for `section`, `taxonomy` and `term` types.
 
 {{% note %}}
-**Tip:** The examples below looks long and complex. That is the flexibility talking. Most Hugo sites contain just a handful of templates:
+**Tip:** The examples below look long and complex. That is the flexibility talking. Most Hugo sites contain just a handful of templates:
 
 ```bash
 ├── _default

docs/content/en/variables/page.md

@@ -82,7 +82,7 @@ See [`.Scratch`](/functions/scratch/) for page-scoped, writable variables.
 : the meta keywords for the content.
 
 .Kind
-: the page's *kind*. Possible return values are `page`, `home`, `section`, `taxonomy`, or `taxonomyTerm`. Note that there are also `RSS`, `sitemap`, `robotsTXT`, and `404` kinds, but these are only available during the rendering of each of these respective page's kind and therefore *not* available in any of the `Pages` collections.
+: the page's *kind*. Possible return values are `page`, `home`, `section`, `taxonomy`, or `term`. Note that there are also `RSS`, `sitemap`, `robotsTXT`, and `404` kinds, but these are only available during the rendering of each of these respective page's kind and therefore *not* available in any of the `Pages` collections.
 
 .Language
 : a language object that points to the language's definition in the site `config`. `.Language.Lang` gives you the language code.
@@ -204,7 +204,7 @@ aliased form `.Pages`.
 
 ### `.Pages` compared to `.Site.Pages`
 
-{{< readfile file="/content/en/readfiles/pages-vs-site-pages.md" markdown="true" >}}
+{{< getcontent path="readfiles/pages-vs-site-pages.md" >}}
 
 ## Page-level Params
 

docs/content/en/variables/site.md

@@ -96,7 +96,7 @@ All the methods below, e.g. `.Site.RegularPages` can also be reached via the glo
 : top-level directories of the site.
 
 .Site.Taxonomies
-: the [taxonomies](/taxonomies/usage/) for the entire site.  Also see section [Taxonomies elsewhere](#taxonomies-elsewhere).
+: the [taxonomies](/taxonomies/usage/) for the entire site. Also see section [Use `.Site.Taxonomies` Outside of Taxonomy Templates](/variables/taxonomy/#use-sitetaxonomies-outside-of-taxonomy-templates).
 
 .Site.Title
 : a string representing the title of the site.
@@ -127,7 +127,7 @@ You can use `.Site.Params` in a [partial template](/templates/partials/) to call
 
 ### `.Site.Pages` compared to `.Pages`
 
-{{< readfile file="/content/en/readfiles/pages-vs-site-pages.md" markdown="true" >}}
+{{< getcontent path="readfiles/pages-vs-site-pages.md" >}}
 
 
 

docs/hugo_stats.json

@@ -0,0 +1,820 @@
+{
+  "htmlElements": {
+    "tags": [
+      "",
+      "a",
+      "article",
+      "aside",
+      "blockquote",
+      "body",
+      "br",
+      "button",
+      "circle",
+      "code",
+      "date",
+      "dd",
+      "div",
+      "dl",
+      "dt",
+      "em",
+      "figcaption",
+      "figure",
+      "footer",
+      "form",
+      "g",
+      "h1",
+      "h2",
+      "h3",
+      "h4",
+      "h5",
+      "h6",
+      "head",
+      "header",
+      "hr",
+      "html",
+      "i",
+      "iframe",
+      "img",
+      "li",
+      "link",
+      "main",
+      "meta",
+      "nav",
+      "noscript",
+      "ol",
+      "p",
+      "path",
+      "pre",
+      "script",
+      "section",
+      "small",
+      "span",
+      "strong",
+      "style",
+      "sup",
+      "svg",
+      "table",
+      "tbody",
+      "td",
+      "thead",
+      "time",
+      "title",
+      "tr",
+      "ul"
+    ],
+    "classes": [
+      "!('about'",
+      "!('content-management'",
+      "!('contribute'",
+      "!('functions'",
+      "!('getting-started'",
+      "!('hosting-and-deployment'",
+      "!('modules'",
+      "!('pipes'",
+      "!('templates'",
+      "!('tools'",
+      "!('troubleshooting'",
+      "!('variables'",
+      "\u0026\u0026",
+      "(false",
+      "(true",
+      "-ml-px",
+      "-mr-12",
+      "-mr-3",
+      "-translate-x-3",
+      "-translate-y-2",
+      "absolute",
+      "absolute-l",
+      "active",
+      "admonition",
+      "admonition-content",
+      "admonition-icon",
+      "anchor",
+      "b--moon-gray",
+      "benchstat",
+      "better",
+      "bg-accent-color-dark",
+      "bg-animate",
+      "bg-black",
+      "bg-carrot-500",
+      "bg-cover",
+      "bg-gradient-to-b",
+      "bg-gray-100",
+      "bg-gray-200",
+      "bg-gray-300",
+      "bg-gray-50",
+      "bg-gray-600",
+      "bg-gray-900",
+      "bg-green-100",
+      "bg-mango-300",
+      "bg-mango-50",
+      "bg-near-white",
+      "bg-opacity-20",
+      "bg-opacity-75",
+      "bg-orange-500",
+      "bg-steel-200",
+      "bg-steel-500",
+      "bg-steel-600",
+      "bg-steel-800",
+      "bg-steel-900",
+      "bg-white",
+      "blTK",
+      "black",
+      "block",
+      "bmt1",
+      "border",
+      "border-0",
+      "border-2",
+      "border-b",
+      "border-gray-100",
+      "border-gray-200",
+      "border-gray-300",
+      "border-l",
+      "border-none",
+      "border-r",
+      "border-solid",
+      "border-t",
+      "border-transparent",
+      "bottom-0",
+      "break-inside-avoid-l",
+      "btn-primary",
+      "c",
+      "c1",
+      "chroma",
+      "clearfix",
+      "cm",
+      "code-copy-content",
+      "code-toggle",
+      "column-count-3-l",
+      "column-gap-1-l",
+      "configs",
+      "copy",
+      "cp",
+      "cursor-pointer",
+      "dark:bg-red-800",
+      "dark:border-gray-800",
+      "delta",
+      "details",
+      "dim",
+      "disabled",
+      "divide-gray-200",
+      "divide-x",
+      "err",
+      "f2-fluid",
+      "f6",
+      "filename",
+      "fill-current",
+      "fixed",
+      "fixed-lTK",
+      "flex",
+      "flex-1",
+      "flex-auto",
+      "flex-auto-ns",
+      "flex-col",
+      "flex-column",
+      "flex-none",
+      "flex-shrink-0",
+      "flex-wrap",
+      "fn",
+      "focus:border-steel-500",
+      "focus:outline-none",
+      "focus:ring-1",
+      "focus:ring-2",
+      "focus:ring-inset",
+      "focus:ring-offset-2",
+      "focus:ring-steel-500",
+      "focus:ring-white",
+      "focus:z-10",
+      "font-black",
+      "font-bold",
+      "font-extrabold",
+      "font-extralight",
+      "font-medium",
+      "font-mono",
+      "font-normal",
+      "font-sans",
+      "font-semibold",
+      "footnote-backref",
+      "footnote-ref",
+      "footnotes",
+      "from-primarydark",
+      "gap-4",
+      "ge",
+      "grid",
+      "grid-cols-1",
+      "group",
+      "grow",
+      "gs",
+      "gu",
+      "h-0",
+      "h-0.5",
+      "h-10",
+      "h-12",
+      "h-16",
+      "h-2",
+      "h-32",
+      "h-5",
+      "h-6",
+      "h-64",
+      "h-8",
+      "h-full",
+      "h-screen",
+      "h6",
+      "hidden",
+      "highlight",
+      "hl",
+      "hover",
+      "hover-bg-green",
+      "hover-bg-near-white",
+      "hover-bg-primary-color",
+      "hover-bg-primary-color-dark",
+      "hover-blue",
+      "hover:bg-gray-300",
+      "hover:bg-gray-50",
+      "hover:bg-steel-500",
+      "hover:bg-steel-700",
+      "hover:border",
+      "hover:text-gray-200",
+      "hover:text-gray-900",
+      "hover:text-hotpink-400",
+      "hover:text-hotpink-600",
+      "hover:text-limegreen-900",
+      "hover:text-royalblue-700",
+      "hover:text-steel-500",
+      "hover:text-white",
+      "img",
+      "in",
+      "inline-block",
+      "inline-flex",
+      "inset-0",
+      "inset-x-0",
+      "instagram-media",
+      "items-center",
+      "items-start",
+      "justify-between",
+      "justify-center",
+      "justify-end",
+      "k",
+      "kc",
+      "kd",
+      "kr",
+      "kt",
+      "l",
+      "language-asciidoc",
+      "language-bash",
+      "language-go",
+      "language-go-html-template",
+      "language-go-text-template",
+      "language-html",
+      "language-js",
+      "language-json",
+      "language-markdown",
+      "language-md",
+      "language-ps1",
+      "language-sh",
+      "language-svg",
+      "language-text",
+      "language-toml",
+      "language-txt",
+      "language-xml",
+      "language-yaml",
+      "language-yml",
+      "lazyload",
+      "ld",
+      "lead",
+      "leading-none",
+      "leading-normal",
+      "leading-relaxed",
+      "leading-snug",
+      "leading-tight",
+      "left-0",
+      "lg:bg-steel-700",
+      "lg:block",
+      "lg:flex",
+      "lg:flex-grow",
+      "lg:flex-shrink-0",
+      "lg:hidden",
+      "lg:inline-block",
+      "lg:items-center",
+      "lg:max-w-lg",
+      "lg:mb-0",
+      "lg:mr-auto",
+      "lg:mt-0",
+      "lg:p-4",
+      "lg:pb-5",
+      "lg:prose-lg",
+      "lg:pt-0",
+      "lg:px-4",
+      "lg:px-5",
+      "lg:px-8",
+      "lg:py-5",
+      "lg:py-8",
+      "lg:rounded-md",
+      "lg:shadow-lg",
+      "lg:space-x-4",
+      "lg:text-5xl",
+      "lg:w-1/2",
+      "lg:w-1/4",
+      "lg:w-1/5",
+      "lg:w-11/12",
+      "lg:w-3/5",
+      "lg:w-4/5",
+      "lg:w-auto",
+      "light-gray",
+      "link",
+      "list-reset",
+      "lnt",
+      "lntable",
+      "lntd",
+      "m",
+      "m-0",
+      "m-1",
+      "max-w-6xl",
+      "max-w-lg",
+      "max-w-xs",
+      "mb-0",
+      "mb-1",
+      "mb-2",
+      "mb-3",
+      "mb-4",
+      "mb-8",
+      "mb5",
+      "mb7",
+      "md:flex",
+      "md:flex-col",
+      "md:flex-grow",
+      "md:grid-cols-2",
+      "md:mt-8",
+      "md:pb-12",
+      "menu))",
+      "menu['about']",
+      "menu['content-management']",
+      "menu['contribute']",
+      "menu['functions']",
+      "menu['getting-started']",
+      "menu['hosting-and-deployment']",
+      "menu['modules']",
+      "menu['pipes']",
+      "menu['templates']",
+      "menu['tools']",
+      "menu['troubleshooting']",
+      "menu['variables']",
+      "mf",
+      "mi",
+      "min-h-screen",
+      "min-w-0",
+      "minor",
+      "ml-1",
+      "ml-10",
+      "ml-4",
+      "ml-6",
+      "ml1",
+      "mr-1.5",
+      "mr-10",
+      "mr-3",
+      "mr-4",
+      "mt-0",
+      "mt-1",
+      "mt-2",
+      "mt-4",
+      "mt-5",
+      "mt-6",
+      "mt-8",
+      "mt3",
+      "mt4",
+      "mv2",
+      "mv3",
+      "mv4",
+      "mv6",
+      "mw-100",
+      "mw5-l",
+      "mx-auto",
+      "my-0",
+      "n",
+      "na",
+      "navbar-menu",
+      "nb",
+      "needs-js",
+      "nested-blockquote",
+      "nested-copy-seperator",
+      "nested-img",
+      "nested-links",
+      "nested-linksTK",
+      "nested-list-reset",
+      "nf",
+      "ni",
+      "nightwind",
+      "nightwind-prevent",
+      "nightwind-prevent-block",
+      "nn",
+      "no-js",
+      "no-underline",
+      "nodelta",
+      "note",
+      "note-icon",
+      "nt",
+      "nt3",
+      "nv",
+      "nx",
+      "o",
+      "o-0",
+      "o-80",
+      "oldnew",
+      "opacity-60",
+      "open",
+      "order-0",
+      "order-0-l",
+      "order-1",
+      "order-1-l",
+      "order-2",
+      "output-content",
+      "overflow-hidden",
+      "overflow-x-scroll",
+      "overflow-y-auto",
+      "p",
+      "p-0",
+      "p-2",
+      "p-3",
+      "p-4",
+      "p-5",
+      "p-8",
+      "pa4-m",
+      "page-item",
+      "page-link",
+      "pagination",
+      "pb-1",
+      "pb-2",
+      "pb-3",
+      "pb-4",
+      "pb-5",
+      "pb-7",
+      "pb-8",
+      "pb2",
+      "ph1",
+      "ph2",
+      "ph4",
+      "pl-0",
+      "pl-1",
+      "pl-2",
+      "pl-3",
+      "pl-6",
+      "pl5-l",
+      "pr-2",
+      "pr1",
+      "primary-color",
+      "prose",
+      "pt-0",
+      "pt-1",
+      "pt-2",
+      "pt-3",
+      "pt-4",
+      "pt-5",
+      "pv1",
+      "px-0",
+      "px-2",
+      "px-3",
+      "px-4",
+      "py-0",
+      "py-0.5",
+      "py-1.5",
+      "py-2",
+      "py-3",
+      "py-4",
+      "py-6",
+      "relative",
+      "right-0",
+      "rounded",
+      "rounded-full",
+      "rounded-l-lg",
+      "rounded-l-md",
+      "rounded-lg",
+      "rounded-md",
+      "rounded-r-md",
+      "row",
+      "s",
+      "s1",
+      "s2",
+      "san-serif",
+      "se",
+      "shadow",
+      "shadow-lg",
+      "shadow-md",
+      "shadow-sm",
+      "show",
+      "sm:flex",
+      "sm:grid-cols-2",
+      "sm:mb-0",
+      "sm:mt-0",
+      "sm:mt-8",
+      "sm:p-4",
+      "sm:pb-0",
+      "sm:pb-6",
+      "sm:pt-3",
+      "sm:pt-5",
+      "sm:px-4",
+      "sm:px-5",
+      "sm:px-6",
+      "sm:py-0",
+      "sm:py-4",
+      "sm:py-5",
+      "sm:py-6",
+      "sm:text-2xl",
+      "sm:text-4xl",
+      "sm:text-base",
+      "sm:text-center",
+      "sm:text-left",
+      "sm:w-1/2",
+      "sm:w-1/5",
+      "sm:w-11/12",
+      "sm:w-4/5",
+      "space-x-4",
+      "space-x-8",
+      "space-y-1",
+      "sr-only",
+      "table",
+      "table-bordered",
+      "tc",
+      "text-2xl",
+      "text-3xl",
+      "text-4xl",
+      "text-5xl",
+      "text-base",
+      "text-black",
+      "text-center",
+      "text-gray-200",
+      "text-gray-300",
+      "text-gray-400",
+      "text-gray-500",
+      "text-gray-600",
+      "text-gray-900",
+      "text-lg",
+      "text-limegreen-600",
+      "text-limegreen-700",
+      "text-mango-100",
+      "text-mango-300",
+      "text-md",
+      "text-royalblue-500",
+      "text-royalblue-600",
+      "text-sm",
+      "text-steel-100",
+      "text-steel-500",
+      "text-steel-900",
+      "text-white",
+      "text-xl",
+      "text-xs",
+      "tile",
+      "tip",
+      "tip-icon",
+      "to-steel-800",
+      "top-0",
+      "top-2",
+      "tracked",
+      "tracking-normal",
+      "tracking-tight",
+      "transform",
+      "twitter-tweet",
+      "unchanged",
+      "uppercase",
+      "v-base",
+      "v-mid",
+      "v-top",
+      "w",
+      "w-1/5",
+      "w-10",
+      "w-11/12",
+      "w-12",
+      "w-14",
+      "w-2",
+      "w-2/3",
+      "w-30-l",
+      "w-32",
+      "w-5",
+      "w-50-m",
+      "w-6",
+      "w-64",
+      "w-8",
+      "w-80-nsTK",
+      "w-96",
+      "w-auto",
+      "w-full",
+      "w-two-third-l",
+      "warning",
+      "whitespace-no-wrap",
+      "worse",
+      "x",
+      "xl:flex",
+      "xl:flex-col",
+      "z-0",
+      "z-40",
+      "z-999",
+      "||"
+    ],
+    "ids": [
+      ".gitlab-ci.yml",
+      "/blog/greatest-city/index.html",
+      "/content/actors/bruce-willis/_index.md",
+      "/layouts/shortcodes/img.html",
+      "/layouts/shortcodes/vimeo.html",
+      "/layouts/shortcodes/year.html",
+      "/layouts/shortcodes/youtube.html",
+      "/themes/yourtheme/layouts/review/single.html",
+      "404.html",
+      "TableOfContents",
+      "addrobotstxt.sh",
+      "all-taxonomies-keys-and-pages.html",
+      "all-taxonomies.html",
+      "archetype-example.sh",
+      "archetypes/functions.md",
+      "archetypes/newsletter.md",
+      "articles.html",
+      "asciicast-3mf1JGaN0AX0Z7j5kLGl3hSh8",
+      "asciicast-7naKerRYUGVPj8kiDmdh5k5h9",
+      "asciicast-BvJBsF6egk9c163bMsObhuNXj",
+      "asciicast-ItACREbFgvJ0HjnSNeTknxWy9",
+      "asciicast-Lc5iwTVny2kuUC8lqvNnL6oDU",
+      "asciicast-eUojYCfRTZvkEiqc52fUsJRBR",
+      "bad-url-sidebar-menu-output.html",
+      "base-64-output.html",
+      "base64-input.html",
+      "baseof.html",
+      "bf-config.toml",
+      "bf-config.yml",
+      "boxfile.yml",
+      "breadcrumb.html",
+      "check-title-length.html",
+      "clone-herring-cove-theme.sh",
+      "config.toml",
+      "content-header.html",
+      "content-image.md",
+      "content/blog/greatest-city.md",
+      "content/posts/_index.md",
+      "content/posts/default-function-example.md",
+      "content/posts/my-awesome-post.md",
+      "content/posts/my-post.md",
+      "content/posts/old-post.md",
+      "content/posts/old-url.md",
+      "content/tutorials/learn-html.md",
+      "correct-url-sidebar-menu-output.html",
+      "delimit-example-front-matter.toml",
+      "delimit-page-tags-final-and-input.html",
+      "delimit-page-tags-final-and-output.html",
+      "delimit-page-tags-input.html",
+      "delimit-page-tags-output.html",
+      "disqus.html",
+      "dot-notation-default-return-value.html",
+      "dot-notation-default-value.html",
+      "example-tweet-input.md",
+      "example-tweet-output.html",
+      "example-vimeo-input.md",
+      "example-vimeo-output.html",
+      "example-youtube-input-with-autoplay.md",
+      "example-youtube-input-with-title.md",
+      "example-youtube-input.md",
+      "example-youtube-output.html",
+      "example.com/posts/index.html",
+      "example.com/quote/index.html",
+      "external-links.svg",
+      "figure-input-example.md",
+      "figure-output-example.html",
+      "first-and-where-together.html",
+      "fn:1",
+      "fn:2",
+      "fnref:1",
+      "fnref:2",
+      "footer.html",
+      "from-gh.sh",
+      "gist-input.md",
+      "gist-output.html",
+      "gitignore.sh",
+      "gohugoio",
+      "grab-top-two-tags.html",
+      "header.html",
+      "highlight-example.md",
+      "how-many-posts.html",
+      "hugo-new-site.sh",
+      "if-instead-of-default.html",
+      "img-output.html",
+      "index.html",
+      "instagram-hide-caption-output.html",
+      "instagram-input-hide-caption.md",
+      "instagram-input.md",
+      "install-brew.sh",
+      "install-extended-with-chocolatey.ps1",
+      "install-go.sh",
+      "install-openssh.sh",
+      "install-with-chocolatey.ps1",
+      "install-with-homebrew.sh",
+      "install-with-linuxbrew.sh",
+      "install-with-macports.sh",
+      "install.sh",
+      "layout/_default/section.html",
+      "layout/_default/single.html",
+      "layouts/404.html",
+      "layouts/_default/_markup/render-heading.html",
+      "layouts/_default/_markup/render-image.html",
+      "layouts/_default/_markup/render-link.html",
+      "layouts/_default/baseof.html",
+      "layouts/_default/li.html",
+      "layouts/_default/list.html",
+      "layouts/_default/section.html",
+      "layouts/_default/single.html",
+      "layouts/_default/summary.html",
+      "layouts/_default/taxonomy.html",
+      "layouts/index.html",
+      "layouts/partials/all-taxonomies.html",
+      "layouts/partials/alllanguages.html",
+      "layouts/partials/bad-url-sidebar-menu.html",
+      "layouts/partials/breadcrumb.html",
+      "layouts/partials/by-date-reverse.html",
+      "layouts/partials/by-date.html",
+      "layouts/partials/by-expiry-date.html",
+      "layouts/partials/by-group-by-page.html",
+      "layouts/partials/by-last-mod.html",
+      "layouts/partials/by-length.html",
+      "layouts/partials/by-link-title.html",
+      "layouts/partials/by-nested-param.html",
+      "layouts/partials/by-page-date.html",
+      "layouts/partials/by-page-expiry-date.html",
+      "layouts/partials/by-page-field.html",
+      "layouts/partials/by-page-lastmod.html",
+      "layouts/partials/by-page-param-as-date.html",
+      "layouts/partials/by-page-param.html",
+      "layouts/partials/by-page-publish-date.html",
+      "layouts/partials/by-publish-date.html",
+      "layouts/partials/by-rating.html",
+      "layouts/partials/by-title.html",
+      "layouts/partials/by-weight.html",
+      "layouts/partials/content-header.html",
+      "layouts/partials/correct-url-sidebar-menu.html",
+      "layouts/partials/default-order.html",
+      "layouts/partials/disqus.html",
+      "layouts/partials/footer.html",
+      "layouts/partials/get-csv.html",
+      "layouts/partials/groups.html",
+      "layouts/partials/head.html",
+      "layouts/partials/header.html",
+      "layouts/partials/i18nlist.html",
+      "layouts/partials/post-tag-link.html",
+      "layouts/partials/post-tag-list.html",
+      "layouts/partials/related.html",
+      "layouts/partials/schemaorg-metadata.html",
+      "layouts/partials/sidebar.html",
+      "layouts/partials/svgs/external-links.svg",
+      "layouts/partials/toc.html",
+      "layouts/partials/twitter.html",
+      "layouts/partials/upcoming-events.html",
+      "layouts/posts/single.html",
+      "layouts/robots.txt",
+      "layouts/section/articles.html",
+      "layouts/section/posts.html",
+      "layouts/shortcodes/gallery.html",
+      "layouts/shortcodes/img.html",
+      "layouts/shortcodes/imgproc.html",
+      "li.html",
+      "links-to-all-tags.html",
+      "list.html",
+      "netlify.toml",
+      "note-with-heading.html",
+      "note-with-heading.md",
+      "page-list-with-summaries.html",
+      "partial-cached-example.html",
+      "partials/templates/random-tweets.html",
+      "post-tag-list.html",
+      "prose",
+      "push-wecker-to-gh.sh",
+      "range-through-tags-w-global.html",
+      "remove-herring-cove-git.sh",
+      "robots.txt",
+      "schemaorg-metadata.html",
+      "section.html",
+      "setup-gh-repo.sh",
+      "shuffle-input.html",
+      "shuffle-output.html",
+      "sidebar.html",
+      "single.html",
+      "slice.html",
+      "summary.html",
+      "syntax-highlighted.html",
+      "tags-range-with-page-variable.html",
+      "taxonomy.html",
+      "time-passed.html",
+      "tip-output.html",
+      "toc.html",
+      "tutorials/learn-html/index.html",
+      "tweets.html",
+      "unix-to-month-integer.html",
+      "upcoming-events.html",
+      "using-tip.md",
+      "variable-as-default-value.html",
+      "vimeo-iframes.html",
+      "warning-admonition-input.md",
+      "warning-admonition-output.html",
+      "wercker-build-step.yml",
+      "wercker.yml",
+      "where-intersect-variables.html",
+      "with-instead-of-default.html",
+      "yourbaseurl/review/book01/index.html",
+      "youtube-embed.html"
+    ]
+  }
+}

docs/layouts/shortcodes/getcontent.html

@@ -0,0 +1,21 @@
+<!-- {{/*
+Insert `.Content` from a (headless) bundle. You can insert `.Content` from multiple page resources of the same bundle by specifying `glob`.
+
+Usage: {{< getcontent path="PATH/TO/FILE" >}}
+       {{< getcontent path="PATH/TO/BUNDLE/" glob="*_PATTERN.md" >}}
+*/}} -->
+{{- $path := .Get "path" -}}
+{{ $glob := .Get "glob" -}}
+
+{{ $resources := slice -}}
+{{ with $glob -}}
+  {{ $bundle := site.GetPage $path -}}
+  {{ $resources = $bundle.Resources.Match $glob -}}
+{{ else -}}
+  {{ $bundle := site.GetPage (path.Dir $path) -}}
+  {{ $resources = $bundle.Resources.Match (path.Base $path) -}}
+{{ end -}}
+
+{{ range $resources -}}
+  {{ .Content }}
+{{ end -}}

docs/netlify.toml

@@ -3,7 +3,7 @@ publish = "public"
 command = "hugo --gc --minify"
 
 [context.production.environment]
-HUGO_VERSION = "0.82.1"
+HUGO_VERSION = "0.83.1"
 HUGO_ENV = "production"
 HUGO_ENABLEGITINFO = "true"
 
@@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
 command = "hugo --gc --minify --enableGitInfo"
 
 [context.split1.environment]
-HUGO_VERSION = "0.82.1"
+HUGO_VERSION = "0.83.1"
 HUGO_ENV = "production"
 
 [context.deploy-preview]
 command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
 
 [context.deploy-preview.environment]
-HUGO_VERSION = "0.82.1"
+HUGO_VERSION = "0.83.1"
 
 [context.branch-deploy]
 command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
 
 [context.branch-deploy.environment]
-HUGO_VERSION = "0.82.1"
+HUGO_VERSION = "0.83.1"
 
 [context.next.environment]
 HUGO_ENABLEGITINFO = "true"