Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/gohugoio/hugo.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorBjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>2018-03-11 22:40:26 +0300
committerBjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>2018-03-11 22:40:26 +0300
commit95d62004a07d8bb6d2b94a56112fd419db7eeb65 (patch)
treeb0958861ece2af8aa1b3e14b604c4c49f0728793 /docs
parent68bf1511f2be39b6576d882d071196e477c72c9f (diff)
parentc0290655825e7bb36e13fb39f89d85b392cf1adc (diff)
Merge commit 'c0290655825e7bb36e13fb39f89d85b392cf1adc'
Diffstat (limited to 'docs')
-rw-r--r--docs/README.md6
-rw-r--r--docs/content/content-management/archetypes.md171
-rw-r--r--docs/content/content-management/cross-references.md14
-rw-r--r--docs/content/content-management/formats.md4
-rw-r--r--docs/content/content-management/menus.md22
-rw-r--r--docs/content/content-management/page-bundles.md24
-rw-r--r--docs/content/content-management/types.md4
-rw-r--r--docs/content/functions/format.md7
-rw-r--r--docs/content/functions/index-function.md2
-rw-r--r--docs/content/functions/range.md2
-rw-r--r--docs/content/functions/title.md2
-rw-r--r--docs/content/functions/where.md2
-rw-r--r--docs/content/functions/with.md2
-rw-r--r--docs/content/getting-started/configuration.md438
-rw-r--r--docs/content/news/0.37-relnotes/featured-hugo-37-poster.pngbin0 -> 186693 bytes
-rw-r--r--docs/content/news/0.37-relnotes/index.md7
-rw-r--r--docs/content/news/0.37.1-relnotes/index.md6
-rw-r--r--docs/content/showcase/small-multiples/bio.md3
-rw-r--r--docs/content/showcase/small-multiples/featured-small-multiples.pngbin0 -> 374273 bytes
-rw-r--r--docs/content/showcase/small-multiples/index.md47
-rw-r--r--docs/content/templates/data-templates.md2
-rw-r--r--docs/content/templates/lists.md10
-rw-r--r--docs/content/templates/rss.md50
-rw-r--r--docs/content/tools/search.md2
-rw-r--r--docs/content/troubleshooting/faq.md5
-rw-r--r--docs/content/variables/taxonomy.md6
-rw-r--r--docs/data/docs.json186
-rw-r--r--docs/layouts/shortcodes/code.html9
-rw-r--r--docs/netlify.toml8
-rw-r--r--docs/resources/_gen/images/content-management/organization/1-featured-content-bundles_hu3e3ae7839b071119f32acaa20f204198_63640_300x0_resize_catmullrom_2.png (renamed from docs/resources/_gen/images/content-management/organization/1-featured-content-bundles_hu3e3ae7839b071119f32acaa20f204198_63640_300x0_resize_catmullrom.png)bin30621 -> 30621 bytes
-rw-r--r--docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom.pngbin77549 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom_2.pngbin0 -> 31698 bytes
-rw-r--r--docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom.pngbin130881 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom_2.pngbin0 -> 50818 bytes
-rw-r--r--docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom.pngbin89104 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom_2.pngbin0 -> 34288 bytes
-rw-r--r--docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom.pngbin151455 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom_2.pngbin0 -> 54567 bytes
-rw-r--r--docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom.pngbin102051 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom_2.pngbin0 -> 37252 bytes
-rw-r--r--docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom.pngbin179713 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom_2.pngbin0 -> 60111 bytes
-rw-r--r--docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom.pngbin77946 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom_2.pngbin0 -> 30114 bytes
-rw-r--r--docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom.pngbin130419 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom_2.pngbin0 -> 48522 bytes
-rw-r--r--docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_480x0_resize_catmullrom_2.pngbin0 -> 60209 bytes
-rw-r--r--docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_640x0_resize_catmullrom_2.pngbin0 -> 100937 bytes
-rw-r--r--docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top.pngbin290059 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top_2.pngbin0 -> 128594 bytes
-rw-r--r--docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom.pngbin107351 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom_2.pngbin0 -> 52357 bytes
-rw-r--r--docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8714c8c914d32c12c7eb833a42713319.pngbin0 -> 36323 bytes
-rw-r--r--docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8b32e959be6137399a224ecc56caffb1.pngbin72430 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_02c2d5bfbe1f2c621df733e4d040574d.pngbin143056 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top.pngbin474464 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top_2.pngbin0 -> 283187 bytes
-rw-r--r--docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom.pngbin210913 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom_2.pngbin0 -> 119036 bytes
-rw-r--r--docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_a6f43693b7589a8d91c844654967eb51.pngbin0 -> 78247 bytes
-rw-r--r--docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_1024x512_fill_catmullrom_top_2.png (renamed from docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_1024x512_fill_catmullrom_top.png)bin57772 -> 57772 bytes
-rw-r--r--docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_640x0_resize_catmullrom_2.png (renamed from docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_640x0_resize_catmullrom.png)bin29073 -> 29073 bytes
-rw-r--r--docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_97b33e8221e700cd517d4ce317c69e48.png (renamed from docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_7af7b624b13f6554ad54ee33f84bf08e.png)bin21333 -> 21333 bytes
-rw-r--r--docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_1024x512_fill_catmullrom_top_2.png (renamed from docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_1024x512_fill_catmullrom_top.png)bin169210 -> 169210 bytes
-rw-r--r--docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_640x0_resize_catmullrom_2.png (renamed from docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_640x0_resize_catmullrom.png)bin77047 -> 77047 bytes
-rw-r--r--docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_7e3f008d047fb3522bf02df4e9229522.pngbin0 -> 53399 bytes
-rw-r--r--docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_978ff9297dc1d5096773813d2df58a6f.pngbin54014 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_1024x512_fill_catmullrom_top_2.png (renamed from docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_1024x512_fill_catmullrom_top.png)bin280168 -> 280168 bytes
-rw-r--r--docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_3b6053b86d6afebe8262ece1955ed6cf.pngbin0 -> 89438 bytes
-rw-r--r--docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_640x0_resize_catmullrom_2.png (renamed from docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_640x0_resize_catmullrom.png)bin129787 -> 129787 bytes
-rw-r--r--docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_9a216d034e8628dd139a6a7fa62712b4.pngbin90077 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top.pngbin187835 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top_2.pngbin0 -> 97618 bytes
-rw-r--r--docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_5f4044a9cb8ece7d6e61bd0e0fb32a0d.pngbin63795 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom.pngbin91851 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom_2.pngbin0 -> 47639 bytes
-rw-r--r--docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_671a5c232ffa27a2cf198d2c39f253eb.pngbin0 -> 33218 bytes
-rw-r--r--docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_0be9b039f9029effab69b9239e224cf7.pngbin0 -> 10934 bytes
-rw-r--r--docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top.pngbin78628 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top_2.pngbin0 -> 30468 bytes
-rw-r--r--docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_34aaa1bbe5cc1b4798bfff8f28e1033e.pngbin27837 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom.pngbin38945 -> 0 bytes
-rw-r--r--docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom_2.pngbin0 -> 15064 bytes
-rw-r--r--docs/themes/gohugoioTheme/data/sponsors.toml6
-rw-r--r--docs/themes/gohugoioTheme/layouts/partials/gtag.html4
-rwxr-xr-xdocs/themes/gohugoioTheme/static/images/gopher-side_color.svg (renamed from docs/static/images/gopher-side_color.svg)0
-rw-r--r--docs/themes/gohugoioTheme/static/images/sponsors/forestry-logotype.svg2
-rw-r--r--docs/themes/gohugoioTheme/static/images/sponsors/linode-logo_standard_light_medium.pngbin0 -> 30887 bytes
88 files changed, 506 insertions, 547 deletions
diff --git a/docs/README.md b/docs/README.md
index d82776de3..5f47e8a1e 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -10,6 +10,12 @@ Note that this repository contains solely the documentation for Hugo. For contri
*Pull requests shall **only** contain changes to the actual documentation. However, changes on the code base of Hugo **and** the documentation shall be a single, atomic pull request in the [hugo](https://github.com/gohugoio/hugo) repository.*
+Spelling fixes are most welcomed, and if you want to contribute longer sections to the documentation, it would be great if you had these in mind when writing:
+
+* Short is good. People go to the library to read novels. If there is more than one way to _do a thing_ in Hugo, describe the current _best practice_ (avoid "… but you can also do …" and "… in older versions of Hugo you had to …".
+* For examples, try to find short snippets that teaches people about the concept. If the example is also useful as-is (copy and paste), then great, but don't list long and similar examples just so people can use them on their sites.
+* Hugo has users from all over the world, so an easy to understand and [simple English](https://simple.wikipedia.org/wiki/Basic_English) is good.
+
## Branches
* The `master` branch is where the site is automatically built from, and is the place to put changes relevant to the current Hugo version.
diff --git a/docs/content/content-management/archetypes.md b/docs/content/content-management/archetypes.md
index 269fda6db..902373d83 100644
--- a/docs/content/content-management/archetypes.md
+++ b/docs/content/content-management/archetypes.md
@@ -1,10 +1,9 @@
---
title: Archetypes
linktitle: Archetypes
-description: Archetypes allow you to create new instances of content types and set default parameters from the command line.
+description: Archetypes are templates used when creating new content.
date: 2017-02-01
publishdate: 2017-02-01
-lastmod: 2017-02-01
keywords: [archetypes,generators,metadata,front matter]
categories: ["content management"]
menu:
@@ -18,175 +17,59 @@ aliases: [/content/archetypes/]
toc: true
---
-{{% note %}}
-This section is outdated, see https://github.com/gohugoio/hugoDocs/issues/11
-{{% /note %}}
-{{% todo %}}
-See above
-{{% /todo %}}
-
## What are Archetypes?
-**Archetypes** are content files in the [archetypes directory][] of your project that contain preconfigured [front matter][] for your website's [content types][]. Archetypes facilitate consistent metadata across your website content and allow content authors to quickly generate instances of a content type via the `hugo new` command.
-
-{{< youtube bcme8AzVh6o >}}
-
-The `hugo new` generator for archetypes assumes your working directory is the content folder at the root of your project. Hugo is able to infer the appropriate archetype by assuming the content type from the content section passed to the CLI command:
+**Archetypes** are content template files in the [archetypes directory][] of your project that contain preconfigured [front matter][] and possibly also a content disposition for your website's [content types][]. These will be used when you run `hugo new`.
-```
-hugo new <content-section>/<file-name.md>
-```
-We can use this pattern to create a new `.md` file in the `posts` section:
+The `hugo new` uses the `content-section` to find the most suitable archetype template in your project. If your project does not contain any archetype files, it will also look in the theme.
{{< code file="archetype-example.sh" >}}
hugo new posts/my-first-post.md
{{< /code >}}
-{{% note "Override Content Type in a New File" %}}
-To override the content type Hugo infers from `[content-section]`, add the `--kind` flag to the end of the `hugo new` command.
-{{% /note %}}
-
-Running this command in a new site that does not have default or custom archetypes will create the following file:
-
-{{< output file="content/posts/my-first-post.md" >}}
-+++
-date = "2017-02-01T19:20:04-07:00"
-title = "my first post"
-draft = true
-+++
-{{< /output >}}
-
-{{% note %}}
-In this example, if you do not already have a `content/posts` directory, Hugo will create both `content/posts/` and `content/posts/my-first-post.md` for you.
-{{% /note %}}
-
-The auto-populated fields are worth examining:
-
-* `title` is generated from the new content's filename (i.e. in this case, `my-first-post` becomes `"my first post"`)
-* `date` and `title` are the variables that ship with Hugo and are therefore included in *all* content files created with the Hugo CLI. `date` is generated in [RFC 3339 format][] by way of Go's [`now()`][] function, which returns the current time.
-* The third variable, `draft = true`, is *not* inherited by your default or custom archetypes but is included in Hugo's automatically scaffolded `default.md` archetype for convenience.
-
-Three variables per content file are often not enough for effective content management of larger websites. Luckily, Hugo provides a simple mechanism for extending the number of variables through custom archetypes, as well as default archetypes to keep content creation DRY.
-
-## Lookup Order for Archetypes
-
-Similar to the [lookup order for templates][lookup] in your `layouts` directory, Hugo looks for a section- or type-specific archetype, then a default archetype, and finally an internal archetype that ships with Hugo. For example, Hugo will look for an archetype for `content/posts/my-first-post.md` in the following order:
+The above will create a new content file in `content/posts/my-first-post.md` using the first archetype file found of these:
1. `archetypes/posts.md`
2. `archetypes/default.md`
-3. `themes/<THEME>/archetypes/posts.md`
-4. `themes/<THEME>/archetypes/default.md` (Auto-generated with `hugo new site`)
-
-{{% note "Using a Theme Archetype" %}}
-If you wish to use archetypes that ship with a theme, the `theme` field must be specified in your [configuration file](/getting-started/configuration/).
-{{% /note %}}
-
-## Choose Your Archetype's Front Matter Format
-
-By default, `hugo new` content files include front matter in the TOML format regardless of the format used in `archetypes/*.md`.
-
-You can specify a different default format in your site [configuration file][] file using the `metaDataFormat` directive. Possible values are `toml`, `yaml`, and `json`.
-
-## Default Archetypes
-
-Default archetypes are convenient if your content's front matter stays consistent across multiple [content sections][sections].
+3. `themes/my-theme/posts.md`
+4. `themes/my-theme/default.md`
-### Create the Default Archetype
+The last two list items is only applicable if you use a theme and it uses the `my-theme` theme name as an example.
-When you create a new Hugo project using `hugo new site`, you'll notice that Hugo has already scaffolded a file at `archetypes/default.md`.
+## Create a New Archetype Template
-The following examples are from a site that's using `tags` and `categories` as [taxonomies][]. If we assume that all content files will require these two key-values, we can create a `default.md` archetype that *extends* Hugo's base archetype. In this example, we are including "golang" and "hugo" as tags and "web development" as a category.
+A fictional example for the section `newsletter` and the archetype file `archetypes/newsletter.md`. Create a new file in `archetypes/newsletter.md` and open it in a text editor.
-{{< code file="archetypes/default.md" >}}
-+++
-tags = ["golang", "hugo"]
-categories = ["web development"]
-+++
-{{< /code >}}
-
-{{% warning "EOL Characters in Text Editors"%}}
-If you get an `EOF error` when using `hugo new`, add a carriage return after the closing `+++` or `---` for your TOML or YAML front matter, respectively. (See the [troubleshooting article on EOF errors](/troubleshooting/eof-error/) for more information.)
-{{% /warning %}}
-
-### Use the Default Archetype
-
-With an `archetypes/default.md` in place, we can use the CLI to create a new post in the `posts` content section:
-
-{{< code file="new-post-from-default.sh" >}}
-$ hugo new posts/my-new-post.md
-{{< /code >}}
-
-Hugo then creates a new markdown file with the following front matter:
-
-{{< output file="content/posts/my-new-post.md" >}}
-+++
-categories = ["web development"]
-date = "2017-02-01T19:20:04-07:00"
-tags = ["golang", "hugo"]
-title = "my new post"
-+++
-{{< /output >}}
-
-We see that the `title` and `date` key-values have been added in addition to the `tags` and `categories` key-values from `archetypes/default.md`.
-
-{{% note "Ordering of Front Matter" %}}
-You may notice that content files created with `hugo new` do not respect the order of the key-values specified in your archetype files. This is a [known issue](https://github.com/gohugoio/hugo/issues/452).
-{{% /note %}}
-
-## Custom Archetypes
-
-Suppose your site's `posts` section requires more sophisticated front matter than what has been specified in `archetypes/default.md`. You can create a custom archetype for your posts at `archetypes/posts.md` that includes the full set of front matter to be added to the two default archetypes fields.
-
-### Create a Custom Archetype
-
-{{< code file="archetypes/posts.md">}}
-+++
-description = ""
-tags = ""
-categories = ""
-+++
-{{< /code >}}
+{{< code file="archetypes/newsletter.md" >}}
+---
+title: "{{ replace .Name "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+---
-### Use a Custom Archetype
+**Insert Lead paragraph here.**
-With an `archetypes/posts.md` in place, you can use the Hugo CLI to create a new post with your preconfigured front matter in the `posts` content section:
+## New Cool Posts
-{{< code file="new-post-from-custom.sh" >}}
-$ hugo new posts/post-from-custom.md
+{{ range first 10 ( where .Site.RegularPages "Type" "cool" ) }}
+* {{ .Title }}
+{{ end }}
{{< /code >}}
-This time, Hugo recognizes our custom `archetypes/posts.md` archetype and uses it instead of `archetypes/default.md`. The generated file will now include the full list of front matter parameters, as well as the base archetype's `title` and `date`:
+When you create a new newsletter with:
-{{< output file="content/posts/post-from-custom-archetype.md" >}}
-+++
-categories = ""
-date = 2017-02-13T17:24:43-08:00
-description = ""
-tags = ""
-title = "post from custom archetype"
-+++
-{{< /output >}}
+```bash
+hugo new newsletter/the-latest-cool.stuff.md
+```
-### Hugo Docs Custom Archetype
+It will create a new newsletter type of content file based on the archetype template.
-As an example of archetypes in practice, the following is the `functions` archetype from the Hugo docs:
+**Note:** the site will only be built if the `.Site` is in use in the archetype file, and this can be time consuming for big sites.
-{{< code file="archetypes/functions.md" >}}
-{{< readfile file="/archetypes/functions.md" >}}
-{{< /code >}}
+The above _newsletter type archetype_ illustrates the possibilities: The full Hugo `.Site` and all of Hugo&#39;s template funcs can be used in the archetype file.
-{{% note %}}
-The preceding archetype is kept up to date with every Hugo build by using Hugo's [`readFile` function](/functions/readfile/). For similar examples, see [Local File Templates](/templates/files/).
-{{% /note %}}
[archetypes directory]: /getting-started/directory-structure/
-[`now()`]: http://golang.org/pkg/time/#Now
-[configuration file]: /getting-started/configuration/
-[sections]: /content-management/sections/
[content types]: /content-management/types/
[front matter]: /content-management/front-matter/
-[RFC 3339 format]: https://www.ietf.org/rfc/rfc3339.txt
-[taxonomies]: /content-management/taxonomies/
-[lookup]: /templates/lookup/
-[templates]: /templates/
diff --git a/docs/content/content-management/cross-references.md b/docs/content/content-management/cross-references.md
index a2c0de26e..2980719e9 100644
--- a/docs/content/content-management/cross-references.md
+++ b/docs/content/content-management/cross-references.md
@@ -109,8 +109,22 @@ Ensuring heading uniqueness across the site is accomplished with a unique identi
/content-management/cross-references/#hugo-heading-anchors:77cd9ea530577debf4ce0f28c8dca242
```
+### Manually Specifying Anchors
+
+For Markdown content files, if the `headerIds` [Blackfriday extension][bfext] is
+enabled (which it is by default), user can manually specify the anchor for any
+heading.
+
+Few examples:
+
+```
+## Alpha 101 {#alpha}
+
+## Version 1.0 {#version-1-dot-0}
+```
[built-in Hugo shortcodes]: /content-management/shortcodes/#using-the-built-in-shortcodes
[lists]: /templates/lists/
[output formats]: /templates/output-formats/
[shortcode]: /content-management/shortcodes/
+[bfext]: /content-management/formats/#blackfriday-extensions
diff --git a/docs/content/content-management/formats.md b/docs/content/content-management/formats.md
index 6ad665400..be6fb40e4 100644
--- a/docs/content/content-management/formats.md
+++ b/docs/content/content-management/formats.md
@@ -84,7 +84,7 @@ See [Shortcodes][sc] for usage, particularly for the built-in shortcodes that sh
### Code Blocks
-Hugo supports GitHub-flavored markdown's use of triple back ticks, as well as provides a special [`highlight` nested shortcode][hlsc] to render syntax highlighting via [Pygments][]. For usage examples and a complete explanation, see the [syntax highlighting documentation][hl] in [developer tools][].
+Hugo supports GitHub-flavored markdown's use of triple back ticks, as well as provides a special [`highlight` shortcode][hlsc], and syntax highlights those code blocks natively using *Chroma*. Users also have an option to use *Pygments* instead. See the [Syntax Highlighting][hl] section for details.
## Mmark
@@ -231,7 +231,7 @@ Markdown syntax is simple enough to learn in a single sitting. The following are
[fireball]: https://daringfireball.net/projects/markdown/
[gfmtasks]: https://guides.github.com/features/mastering-markdown/#syntax
[helperssource]: https://github.com/gohugoio/hugo/blob/77c60a3440806067109347d04eb5368b65ea0fe8/helpers/general.go#L65
-[hl]: /tools/syntax-highlighting/
+[hl]: /content-management/syntax-highlighting/
[hlsc]: /content-management/shortcodes/#highlight
[hugocss]: /css/style.css
[ietf]: https://tools.ietf.org/html/
diff --git a/docs/content/content-management/menus.md b/docs/content/content-management/menus.md
index 8de808391..26c1eafad 100644
--- a/docs/content/content-management/menus.md
+++ b/docs/content/content-management/menus.md
@@ -137,19 +137,17 @@ Here’s an example snippet pulled from a `config.toml`:
Here's the equivalent snippet in a `config.yaml`:
{{< code file="config.yml" >}}
----
menu:
- docs:
- - Name: "about hugo"
- Pre: "<i class='fa fa-heart'></i>"
- Weight: -110
- Identifier: "about"
- URL: "/about/"
- - Name: "getting started"
- Pre: "<i class='fa fa-road'></i>"
- Weight: -100
- URL: "/getting-started/"
----
+ main:
+ - name: "about hugo"
+ pre: "<i class='fa fa-heart'></i>"
+ weight: -110
+ identifier: "about"
+ url: "/about/"
+ - name: "getting started"
+ pre: "<i class='fa fa-road'></i>"
+ weight: -100
+ url: "/getting-started/"
{{< /code >}}
{{% note %}}
diff --git a/docs/content/content-management/page-bundles.md b/docs/content/content-management/page-bundles.md
index 7c5ca85d6..fbb9025ca 100644
--- a/docs/content/content-management/page-bundles.md
+++ b/docs/content/content-management/page-bundles.md
@@ -6,7 +6,6 @@ lastmod : 2018-01-28T22:26:40-05:00
linktitle : "Page Bundles"
keywords : ["page", "bundle", "leaf", "branch"]
categories : ["content management"]
-draft : true
toc : true
menu :
docs:
@@ -15,19 +14,16 @@ menu :
weight : 11
---
-Page Bundles are a way to organize the content files. It's useful for
-cases where a page or section's content needs to be split into
-multiple content pages for convenience or has associated attachments
-like documents or images.
+Page Bundles are a way to group [Page Resources](/content-management/page-resources/).
-A Page Bundle can be one of two types:
+A Page Bundle can be one of:
-- Leaf Bundle
-- Branch Bundle
+- Leaf Bundle (leaf means it has no children)
+- Branch Bundle (home page, section, taxonomy terms, taxonomy list)
| | Leaf Bundle | Branch Bundle |
|-----------------|--------------------------------------------------------|---------------------------------------------------------|
-| Usage | Collection of content and attachments for single pages | Collection of content and attachments for section pages |
+| Usage           | Collection of resources (pages, images etc.) for single pages | Collection of non-page resources (images etc.)for list pages |
| Index file name | `index.md` [^fn:1] | `_index.md` [^fn:1] |
| Layout type | `single` | `list` |
| Nesting | Doesn't allow nesting of more bundles under it | Allows nesting of leaf/branch bundles under it |
@@ -37,15 +33,7 @@ A Page Bundle can be one of two types:
## Leaf Bundles {#leaf-bundles}
A _Leaf Bundle_ is a directory at any hierarchy within the `content/`
-directory, that contains at least an **`index.md`** file.
-
-{{% note %}}
-Here `md` (markdown) is used just as an example. You can use any file
-type as a content resource as long as it is a MIME type recognized by
-Hugo (`json` files will, as one example, work fine). If you want to
-get exotic, you can define your own media type.
-{{% /note %}}
-
+directory, that contains an **`index.md`** file.
### Examples of Leaf Bundle organization {#examples-of-leaf-bundle-organization}
diff --git a/docs/content/content-management/types.md b/docs/content/content-management/types.md
index f639313c0..dc412af19 100644
--- a/docs/content/content-management/types.md
+++ b/docs/content/content-management/types.md
@@ -54,7 +54,7 @@ layout = "birthday"
+++
{{< /code >}}
-By default, Hugo assumes `*.md` under `events` is of the `events` content type. However, we have specified that this particular file at `content/events/ my-first-event.md` is of type `event` and should render using the `birthday` layout.
+By default, Hugo assumes `*.md` under `events` is of the `events` content type. However, we have specified that this particular file at `content/events/my-first-event.md` is of type `event` and should render using the `birthday` layout.
### Create a Type Layout Directory
@@ -96,4 +96,4 @@ Read [Archetypes][archetypes] for more information on archetype usage with `hugo
[sectiontemplates]: /templates/section-templates/
[sections]: /content-management/sections/
[template]: /templates/
-[Tumblr]: https://www.tumblr.com/ \ No newline at end of file
+[Tumblr]: https://www.tumblr.com/
diff --git a/docs/content/functions/format.md b/docs/content/functions/format.md
index 89d74c241..1d498cc3b 100644
--- a/docs/content/functions/format.md
+++ b/docs/content/functions/format.md
@@ -1,6 +1,6 @@
---
title: .Format
-description: Formats built-in Hugo dates---`.Date`, `.PublishDate`, and `.LastMod`---according to Go's layout string.
+description: Formats built-in Hugo dates---`.Date`, `.PublishDate`, and `.Lastmod`---according to Go's layout string.
godocref: https://golang.org/pkg/time/#example_Time_Format
date: 2017-02-01
publishdate: 2017-02-01
@@ -23,7 +23,7 @@ toc: true
* `.PublishDate`
* `.Date`
-* `.LastMod`
+* `.Lastmod`
Assuming a key-value of `date: 2017-03-03` in a content file's front matter, your can run the date through `.Format` followed by a layout string for your desired output at build time:
@@ -69,9 +69,6 @@ date: 2017-03-03T14:15:59-06:00
`"Mon Jan 2 2006"`
: **Returns**: `Fri Mar 3 2017`
-`"January 2nd"`
-: **Returns**: `March 3rd`
-
`"January 2006"`
: **Returns**: `March 2017`
diff --git a/docs/content/functions/index-function.md b/docs/content/functions/index-function.md
index a0e0ff89c..e5f039caf 100644
--- a/docs/content/functions/index-function.md
+++ b/docs/content/functions/index-function.md
@@ -50,7 +50,7 @@ pop_city = 658390
pop_metro = 1717900
```
-The example we will use will be an article on Oslo, which front matter should set to exactly the same name as the corresponding file name in `data/locations/`:
+The example we will use will be an article on Oslo, whose front matter should be set to exactly the same name as the corresponding file name in `data/locations/`:
```
title = "My Norwegian Vacation"
diff --git a/docs/content/functions/range.md b/docs/content/functions/range.md
index d7efa0732..6f007e93d 100644
--- a/docs/content/functions/range.md
+++ b/docs/content/functions/range.md
@@ -6,7 +6,7 @@ godocref:
date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2017-02-01
-categories: [functions,fundamentals]
+categories: [functions]
menu:
docs:
parent: "functions"
diff --git a/docs/content/functions/title.md b/docs/content/functions/title.md
index 3c8032472..e3a7e9c0b 100644
--- a/docs/content/functions/title.md
+++ b/docs/content/functions/title.md
@@ -6,7 +6,7 @@ godocref:
date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2017-02-01
-categories: [functions,fundamentals]
+categories: [functions]
menu:
docs:
parent: "functions"
diff --git a/docs/content/functions/where.md b/docs/content/functions/where.md
index 574fef2df..3aa03296b 100644
--- a/docs/content/functions/where.md
+++ b/docs/content/functions/where.md
@@ -50,7 +50,7 @@ It can also be used with the logical operators `!=`, `>=`, `in`, etc. Without an
{{ end }}
```
-The following logical operators are vailable with `where`:
+The following logical operators are available with `where`:
`=`, `==`, `eq`
: `true` if a given field value equals a matching value
diff --git a/docs/content/functions/with.md b/docs/content/functions/with.md
index 1f2c4beb1..3fad8bd9c 100644
--- a/docs/content/functions/with.md
+++ b/docs/content/functions/with.md
@@ -6,7 +6,7 @@ godocref:
date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2017-03-12
-categories: [functions,fundamentals]
+categories: [functions]
menu:
docs:
parent: "functions"
diff --git a/docs/content/getting-started/configuration.md b/docs/content/getting-started/configuration.md
index 5249e4fab..b051347d8 100644
--- a/docs/content/getting-started/configuration.md
+++ b/docs/content/getting-started/configuration.md
@@ -1,7 +1,7 @@
---
title: Configure Hugo
linktitle: Configuration
-description: Often the default settings are good enough, but the config file can provide highly granular control over how your site is rendered.
+description: How to configure your Hugo site.
date: 2013-07-01
publishdate: 2017-01-02
lastmod: 2017-03-05
@@ -18,9 +18,201 @@ aliases: [/overview/source-directory/,/overview/configuration/]
toc: true
---
-The [directory structure][] of a Hugo website&mdash;or more precisely, the source organization of files containing the website's content and templates&mdash;provides most of the configuration information that Hugo needs in order to generate a finished website.
-Because of Hugo's sensible defaults, many websites may not need a configuration file. Hugo is designed to recognize certain typical usage patterns.
+## All Configuration Settings
+
+The following is the full list of Hugo-defined variables with its default value in parens.
+
+archetypeDir ("archetypes")
+: The directory where Hugo finds archetype files (content templates).
+
+baseURL
+: Hostname (and path) to the root, e.g. http://bep.is/
+
+buildDrafts (false)
+: Include drafts when building.
+
+buildExpired (false)
+: Include content already expired.
+
+buildFuture (false)
+: Include content with publishdate in the future.
+
+canonifyURLs (false)
+: Enable to turn relative URLs into absolute.
+
+config ("config.toml")
+: Config file (default is path/config.yaml|json|toml).
+
+contentDir ("content")
+: The directory from where Hugo reads content files.
+
+dataDir ("data")
+: The directory from where Hugo reads data files.
+
+defaultContentLanguage ("en")
+: Content without language indicator will default to this language.
+
+defaultContentLanguageInSubdir (false)
+: Renders the default content language in subdir, e.g. /en/. The root directory / will redirect to /en/.
+
+disableHugoGeneratorInject (false)
+: Hugo will, by default, inject a generator meta tag in the HTML head on the _home page only_. You can turn it off, but we would really appreciate if you don't, as this is a good way to watch Hugo's popularity on the rise.
+
+disableKinds ([])
+: Allows you to disable all page types and will render nothing related to 'kind'. Allowed values are "page", "home", "section", "taxonomy", "taxonomyTerm", "RSS", "sitemap", "robotsTXT", "404".
+
+disableLiveReload (false)
+: Turn off automatic live reloading of browser window.
+
+disablePathToLower (false)
+: Do not make the url/path to lowercase.
+
+enableEmoji (false)
+: Enable Emoji emoticons support for page content; see emoji-cheat-sheet.com.
+
+enableGitInfo (false)
+: If the Hugo site is versioned by Git, you will then get a `.GitInfo` object per page, and `Lastmod` will get updated by the last commit date for content.
+
+enableMissingTranslationPlaceholders (false)
+: Show a placeholder instead of the default value or an empty string if a translation is missing
+
+enableRobotsTXT (false)
+: When enabled, Hugo will generate a `robots.txt` file.
+
+footnoteAnchorPrefix ("")
+: A prefix for your footnote anchors.
+
+footnoteReturnLinkContents ("")
+: A return link for your footnote.
+
+googleAnalytics ("")
+: google analytics tracking id
+
+hasCJKLanguage (false)
+: If true, auto-detect Chinese/Japanese/Korean Languages in the content. This will make `.Summary` and `.WordCount` behave correctly in CJK languages.
+
+imaging
+: See [Image Processing Config](/content-management/image-processing/#image-processing-config).
+
+languages
+: See [Configure Languages](/content-management/multilingual/#configure-languages).
+
+languageCode ("")
+: The site's language code.
+
+layoutDir ("layouts")
+: The directory from where Hugo reads layouts (templates).
+
+log (false)
+: Enable logging.
+
+logFile ("")
+: Log File path (if set, logging enabled automatically).
+
+menu
+: See [Add Non-content Entries to a Menu](/content-management/menus/#add-non-content-entries-to-a-menu).
+
+metaDataFormat ("toml")
+: "toml","yaml", or "json"
+
+newContentEditor ("")
+: The editor to use when creating new content.
+
+noChmod (false)
+: Don't sync permission mode of files.
+
+noTimes (false)
+: Don't sync modification time of files
+
+paginate (10)
+: Default number of pages per page in pagination.
+
+paginatePath ("page")
+: The path element used during pagination (http://example.com/page/2).
+
+permalinks
+: See [Content Management](/content-management/urls/#permalinks)
+
+pluralizeListTitles (true)
+: Pluralize titles in lists using inflect.
+
+preserveTaxonomyNames (false)
+: Preserve special characters in taxonomy names ("Gérard Depardieu" vs "Gerard Depardieu").
+
+publishDir ("public")
+: The directory to where Hugo will write the final static site (the HTML files etc.).
+
+pygmentsCodeFencesGuessSyntax (false)
+: Enables syntax guessing for code fences without specified language.
+
+pygmentsStyle ("monokai")
+: Color-codes for highlighting derived from this style. See https://help.farbox.com/pygments.html
+
+pygmentsUseClasses (false)
+: Enable to use external CSS for code highlighting.
+
+related
+: See [Related Content](/content-management/related/#configure-related-content).
+
+relativeURLs (false)
+: Enable this to make all relative URLs relative to content root. Note that this does not affect absolute URLs.
+
+rssLimit (15)
+: Maximum number of items in the RSS feed.
+
+sectionPagesMenu ("")(
+: See ["Section Menu for Lazy Bloggers"](/templates/menu-templates/#section-menu-for-lazy-bloggers).
+
+sitemap
+: Default sitemap configuration.
+
+staticDir ("static")
+: Relative directory from where Hugo reads static files.
+
+stepAnalysis (false)
+: Display memory and timing of different steps of the program.
+
+summaryLength (70)
+: The length of text to show in a `.Summary`.
+
+taxonomies
+: See [Configure Taxonomies](content-management/taxonomies#configure-taxonomies)
+
+theme ("")
+: Theme to use (located by default in /themes/THEMENAME/)
+
+themesDir ("themes")
+: The directory where Hugo reads the themes from.
+
+title ("")
+: Site title.
+
+uglyURLs (false)
+: When enabled creates URL on the form `/filename.html` instead of `/filename/`
+
+verbose (false)
+: Enable verbose output.
+
+verboseLog (false)
+: Enable verbose logging.
+
+watch (false)
+: Watch filesystem for changes and recreate as needed.
+
+{{% note %}}
+If you are developing your site on a \*nix machine, here is a handy shortcut for finding a configuration option from the command line:
+```
+cd ~/sites/yourhugosite
+hugo config | grep emoji
+```
+
+which shows output like
+
+```
+enableemoji: true
+```
+{{% /note %}}
## Configuration Lookup Order
@@ -52,120 +244,6 @@ params:
SidebarRecentLimit: 5
{{< /code >}}
-### All Variables, YAML
-
-The following is the full list of Hugo-defined variables in an example YAML file. The values provided in this example represent the default values used by Hugo.
-
-{{< code file="config.yml" download="config.yml" >}}
-archetypeDir: "archetypes"
-# hostname (and path) to the root, e.g. http://spf13.com/
-baseURL: ""
-# include content marked as draft
-buildDrafts: false
-# include content with publishdate in the future
-buildFuture: false
-# include content already expired
-buildExpired: false
-# enable this to make all relative URLs relative to content root. Note that this does not affect absolute URLs. See the "URL Management" page
-relativeURLs: false
-canonifyURLs: false
-# config file (default is path/config.yaml|json|toml)
-config: "config.toml"
-contentDir: "content"
-dataDir: "data"
-defaultLayout: "post"
-# Missing translations will default to this content language
-defaultContentLanguage: "en"
-# Renders the default content language in subdir, e.g. /en/. The root directory / will redirect to /en/
-defaultContentLanguageInSubdir: false
-disableLiveReload: false
-# Enable GitInfo feature
-enableGitInfo: false
-# Build robots.txt file
-enableRobotsTXT: false
-# Do not inject generator meta tag on homepage
-disableHugoGeneratorInject: false
-# Allows you to disable all page types and will render nothing related to 'kind';
-# values = "page", "home", "section", "taxonomy", "taxonomyTerm", "RSS", "sitemap", "robotsTXT", "404"
-disableKinds: []
-# Do not make the url/path to lowercase
-disablePathToLower: false ""
-# Enable Emoji emoticons support for page content; see emoji-cheat-sheet.com
-enableEmoji: false
-# Show a placeholder instead of the default value or an empty string if a translation is missing
-enableMissingTranslationPlaceholders: false
-footnoteAnchorPrefix: ""
-footnoteReturnLinkContents: ""
-# google analytics tracking id
-googleAnalytics: ""
-# if true, auto-detect Chinese/Japanese/Korean Languages in the content. (.Summary and .WordCount can work properly in CJKLanguage)
-hasCJKLanguage: false
-languageCode: ""
-# the length of text to show in a .Summary
-summaryLength: 70
-layoutDir: "layouts"
-# Enable Logging
-log: false
-# Log File path (if set, logging enabled automatically)
-logFile: ""
-# "toml","yaml", or "json"
-metaDataFormat: "toml"
-newContentEditor: ""
-# Don't sync permission mode of files
-noChmod: false
-# Don't sync modification time of files
-noTimes: false
-# Pagination
-paginate: 10
-paginatePath: "page"
-# See "content-management/permalinks"
-permalinks:
-# Pluralize titles in lists using inflect
-pluralizeListTitles: true
-# Preserve special characters in taxonomy names ("Gérard Depardieu" vs "Gerard Depardieu")
-preserveTaxonomyNames: false
-# filesystem path to write files to
-publishDir: "public"
-# enables syntax guessing for code fences without specified language
-pygmentsCodeFencesGuessSyntax: false
-# color-codes for highlighting derived from this style
-pygmentsStyle: "monokai"
-# true use pygments-css or false will color code directly
-pygmentsUseClasses: false
-# maximum number of items in the RSS feed
-rssLimit: 15
-# see "Section Menu for Lazy Bloggers", /templates/menu-templates for more info
-SectionPagesMenu: ""
-# default sitemap configuration map
-sitemap:
-# filesystem path to read files relative from
-source: ""
-staticDir: "static"
-# display memory and timing of different steps of the program
-stepAnalysis: false
-# display metrics about template executions
-templateMetrics: false
-# theme to use (located by default in /themes/THEMENAME/)
-themesDir: "themes"
-theme: ""
-title: ""
-# Title Case style guide for the title func and other automatic title casing in Hugo.
-// Valid values are "AP" (default), "Chicago" and "Go" (which was what you had in Hugo <= 0.25.1).
-// See https://www.apstylebook.com/ and http://www.chicagomanualofstyle.org/home.html
-titleCaseStyle: "AP"
-# if true, use /filename.html instead of /filename/
-uglyURLs: false
-# verbose output
-verbose: false
-# verbose logging
-verboseLog: false
-# watch filesystem for changes and recreate as needed
-watch: true
-taxonomies:
- - category: "categories"
- - tag: "tags"
-{{< /code >}}
-
## TOML Configuration
The following is an example of a TOML configuration file. The values under `[params]` will populate the `.Site.Params` variable for use in [templates][]:
@@ -188,128 +266,10 @@ title = "My Hugo Site"
author = "John Doe"
{{< /code >}}
-### All Variables, TOML
-
-The following is the full list of Hugo-defined variables in an example TOML file. The values provided in this example represent the default values used by Hugo.
-
-{{< code file="config.toml" download="config.toml">}}
-archetypeDir = "archetypes"
-# hostname (and path) to the root, e.g. http://spf13.com/
-baseURL = ""
-# include content marked as draft
-buildDrafts = false
-# include content with publishdate in the future
-buildFuture = false
-# include content already expired
-buildExpired = false
-# enable this to make all relative URLs relative to content root. Note that this does not affect absolute URLs.
-relativeURLs = false
-canonifyURLs = false
-# config file (default is path/config.yaml|json|toml)
-config = "config.toml"
-contentDir = "content"
-dataDir = "data"
-defaultLayout = "post"
-# Missing translations will default to this content language
-defaultContentLanguage = "en"
-# Renders the default content language in subdir, e.g. /en/. The root directory / will redirect to /en/
-defaultContentLanguageInSubdir = false
-disableLiveReload = false
-# Enable GitInfo feature
-enableGitInfo = false
-# Build robots.txt file
-enableRobotsTXT = false
-# Do not inject generator meta tag on homepage
-disableHugoGeneratorInject = false
-# Allows you to disable all page types and will render nothing related to 'kind';
-# values = "page", "home", "section", "taxonomy", "taxonomyTerm", "RSS", "sitemap", "robotsTXT", "404"
-disableKinds = []
-# Do not make the url/path to lowercase
-disablePathToLower = false
-# Enable Emoji emoticons support for page content; see emoji-cheat-sheet.com
-enableEmoji = false
-# Show a placeholder instead of the default value or an empty string if a translation is missing
-enableMissingTranslationPlaceholders = false
-footnoteAnchorPrefix = ""
-footnoteReturnLinkContents = ""
-# google analytics tracking id
-googleAnalytics = ""
-# if true, auto-detect Chinese/Japanese/Korean Languages in the content. (.Summary and .WordCount can work properly in CJKLanguage)
-hasCJKLanguage = false
-languageCode = ""
-# the length of text to show in a .Summary
-summaryLength = 70
-layoutDir = "layouts"
-# Enable Logging
-log = false
-# Log File path (if set, logging enabled automatically)
-logFile =
-# maximum number of items in the RSS feed
-rssLimit = 15
-# "toml","yaml", or "json"
-metaDataFormat = "toml"
-newContentEditor = ""
-# Don't sync permission mode of files
-noChmod = false
-# Don't sync modification time of files
-noTimes = false
-# Pagination
-paginate = 10
-paginatePath = "page"
-# See "content-management/permalinks"
-permalinks =
-# Pluralize titles in lists using inflect
-pluralizeListTitles = true
-# Preserve special characters in taxonomy names ("Gérard Depardieu" vs "Gerard Depardieu")
-preserveTaxonomyNames = false
-# filesystem path to write files to
-publishDir = "public"
-# enables syntax guessing for code fences without specified language
-pygmentsCodeFencesGuessSyntax = false
-# color-codes for highlighting derived from this style
-pygmentsStyle = "monokai"
-# true: use pygments-css or false: color-codes directly
-pygmentsUseClasses = false
-# see "Section Menu for Lazy Bloggers", /templates/menu-templates for more info
-SectionPagesMenu =
-# default sitemap configuration map
-sitemap =
-# filesystem path to read static files relative from
-staticDir = "static"
-# display memory and timing of different steps of the program
-stepAnalysis = false
-# theme to use (located by default in /themes/THEMENAME/)
-themesDir = "themes"
-theme = ""
-title = ""
-# if true, use /filename.html instead of /filename/
-uglyURLs = false
-# verbose output
-verbose = false
-# verbose logging
-verboseLog = false
-# watch filesystem for changes and recreate as needed
-watch = true
-[taxonomies]
- category = "categories"
- tag = "tags"
-{{< /code >}}
-{{% note %}}
-If you are developing your site on a \*nix machine, here is a handy shortcut for finding a configuration option from the command line:
-```
-cd ~/sites/yourhugosite
-hugo config | grep emoji
-```
-which shows output like
-```
-enableemoji: true
-```
-{{% /note %}}
-
-## Environmental Variables
+## Configure with Environment Variables
In addition to the 3 config options already mentioned, configuration key-values can be defined through operating system environment variables.
@@ -319,10 +279,16 @@ For example, the following command will effectively set a website's title on Uni
$ env HUGO_TITLE="Some Title" hugo
```
+This is really useful if you use a service such as Netlify to deploy your site. Look at the Hugo docs [Netlify configuration file](https://github.com/gohugoio/hugoDocs/blob/master/netlify.toml) for an example.
+
{{% note "Setting Environment Variables" %}}
Names must be prefixed with `HUGO_` and the configuration key must be set in uppercase when setting operating system environment variables.
{{% /note %}}
+{{< todo >}}
+Test and document setting params via JSON env var.
+{{< /todo >}}
+
## Ignore Files When Rendering
The following statement inside `./config.toml` will cause Hugo to ignore files ending with `.foo` and `.boo` when rendering:
diff --git a/docs/content/news/0.37-relnotes/featured-hugo-37-poster.png b/docs/content/news/0.37-relnotes/featured-hugo-37-poster.png
new file mode 100644
index 000000000..9f369ba25
--- /dev/null
+++ b/docs/content/news/0.37-relnotes/featured-hugo-37-poster.png
Binary files differ
diff --git a/docs/content/news/0.37-relnotes/index.md b/docs/content/news/0.37-relnotes/index.md
index cf6697791..a9b6b4cef 100644
--- a/docs/content/news/0.37-relnotes/index.md
+++ b/docs/content/news/0.37-relnotes/index.md
@@ -1,13 +1,12 @@
---
date: 2018-02-27
-title: "0.37"
-description: "0.37"
-slug: "0.37"
+title: "Hugo 0.37: Preserve PNG Colour Palette"
+description: "Reduces processed PNG file sizes. And 0.37 is built with Go 1.10!"
categories: ["Releases"]
---
- The main item in Hugo `0.37` is that we now properly preserve the colour palette when processing `PNG` images. We got reports from users experiencing their `PNG` images getting bigger in file size when scaled down. Now, if you, as an example, start out with a carefully chosen 8 bit colour palette (i.e. `PNG-8`), this is now what you will end up with. A special thanks to [@aitva](https://github.com/aitva) for doing the investigative work finding a proper fix for this issue.
+The main item in Hugo `0.37` is that we now properly preserve the colour palette when processing `PNG` images. We got reports from users experiencing their `PNG` images getting bigger in file size when scaled down. Now, if you, as an example, start out with a carefully chosen 8 bit colour palette (i.e. `PNG-8`), this is now what you will end up with. A special thanks to [@aitva](https://github.com/aitva) for doing the investigative work finding a proper fix for this issue.
This release represents **40 contributions by 5 contributors** to the main Hugo code base.
diff --git a/docs/content/news/0.37.1-relnotes/index.md b/docs/content/news/0.37.1-relnotes/index.md
index 7f53d4127..754ed4240 100644
--- a/docs/content/news/0.37.1-relnotes/index.md
+++ b/docs/content/news/0.37.1-relnotes/index.md
@@ -1,16 +1,14 @@
---
date: 2018-03-07
-title: "0.37.1"
-description: "0.37.1"
+title: "Hugo 0.37.1: One Bugfix"
+description: "Fixes SVG (and similar) handling as page resources."
categories: ["Releases"]
images:
- images/blog/hugo-bug-poster.png
---
-
-
This is a bug-fix release with a one important fix:
Image content such as `SVG` cannot be scaled with the built-in image processing methods, but it should still be possible to use them as page resources. This was a regression in Hugo `0.37` and is now fixed. [ba94abbf](https://github.com/gohugoio/hugo/commit/ba94abbf5dd90f989242af8a7027d67a572a6128) [@bep](https://github.com/bep) [#4455](https://github.com/gohugoio/hugo/issues/4455)
diff --git a/docs/content/showcase/small-multiples/bio.md b/docs/content/showcase/small-multiples/bio.md
new file mode 100644
index 000000000..3e0c1f14a
--- /dev/null
+++ b/docs/content/showcase/small-multiples/bio.md
@@ -0,0 +1,3 @@
+
+Small Multiples is a multidisciplinary team of data specialists, designers and developers that help people make the best use of their data, a journey that starts from strategy, to concepts, mock-ups, prototypes, design, and development.
+
diff --git a/docs/content/showcase/small-multiples/featured-small-multiples.png b/docs/content/showcase/small-multiples/featured-small-multiples.png
new file mode 100644
index 000000000..a278f464d
--- /dev/null
+++ b/docs/content/showcase/small-multiples/featured-small-multiples.png
Binary files differ
diff --git a/docs/content/showcase/small-multiples/index.md b/docs/content/showcase/small-multiples/index.md
new file mode 100644
index 000000000..e2b80ea9a
--- /dev/null
+++ b/docs/content/showcase/small-multiples/index.md
@@ -0,0 +1,47 @@
+---
+
+title: Small Multiples
+date: 2018-02-28
+description: "\"Hugo has excellent support and integration with Netlify and we were immediately blown away by how fast it was.\""
+siteURL: https://smallmultiples.com.au/
+byline: "[Small Multiples](https://smallmultiples.com.au/)"
+draft: true
+---
+
+Previously we had built and hosted our website with SquareSpace. Although SquareSpace was adequate for quickly showcasing our work, we felt it didn’t reflect our technical capabilities and the types of products we build for our clients.
+
+For many client applications, static front-end sites provide fast, scalable solutions that can easily connect with any back-end service, API or static data. We wanted to use the same processes and infrastructure that we use to host and deploy many of our products, so we felt that building a static site was the right solution for our website.
+
+Netlify is a hosting and deployment service that we use for many products. Our developers really like it because it has strong integration with GitHub and it works with the build tools we use such as Yarn and Webpack. It creates a production build every time we commit to our GitHub repository. This means we can share and preview every change internally or with clients.
+
+Application development has become increasingly complex and there is a strong motivation to simplify this process by avoiding complicated backends in favour of applications that consume static data and APIs (a JAMstack).
+
+Libraries like React make this easy, but we also wanted something that was server rendered. This led us to look at React based tools for static site generation such as GatsbyJS. We liked GatsbyJS, but in the end, we didn’t choose it due to the lack of availability of a simple CMS driven data source.
+
+For this, we considered Contentful. Contentful is a beautifully designed application. It’s basically a headless CMS, but it’s not specifically designed for websites and it becomes quite expensive at a commercial level. Their free tier is possibly a good option for personal sites especially with Gatsby. We also evaluated prose.io. This is a free service for editing markdown files in a GitHub repository. It works well, but it’s quite basic and didn’t provide the editing experience we were looking for.
+
+At the same time, we started exploring Hugo. Hugo is a static site generator similar to Jekyll, but it’s written in Go. It has excellent support and integration with Netlify and we were immediately blown away by how fast it was.
+
+We had been closely following the redevelopment of the Smashing Magazine website. We knew this was being powered by Hugo and Netlify and this showed us that Hugo could work for a large scale sites.
+
+The deciding factor, however, was the availability of CMS options that integrate well with Hugo. Netlify has an open source project called NetlifyCMS and there are also hosted services like Forestry.io. These both provide a CMS with an editing interface for markdown files and images. There is no database, instead, changes are committed directly back into the GitHub repository.
+
+In the end, we chose Hugo on Netlify, with Forestry as our CMS. The site is built and redeployed immediately with Netlify watching for changes to the GitHub repository.
+
+Was this the right choice? For us, yes, but we learnt a few things along the way.
+
+The Hugo templating language was very powerful, although also frustrating at times. The queries used to filter list pages are concise but difficult to read. Although it’s easy to get started, Hugo can have a significant learning curve as you try to do more complicated things.
+
+Hugo has particular expectations when it comes to CMS concepts like tags, categories, RSS, related content and menus. Some parts of our initial design did not match perfectly with how these work in Hugo. It took some time to figure out how to make things work the way we wanted without losing all the benefits of structured content.
+
+There were a few teething issues. We picked some relatively new technologies and as a result, we encountered some bugs. We were forced to find some workarounds and logged some issues with Hugo during the course of development. Most of these were fixed and features were added with releases happening frequently over the time we were working on the project. This can be exciting but also frustrating. We can see Hugo is developing in the right direction.
+
+NetlifyCMS was also very new when we first looked at it and this is partly why we opted for Forestry. Forestry is an excellent choice for an out-of-the-box CMS and it needs very little code configuration. It provided a better editing experience for non-technical users. I would still say this is true, but it also provides fewer options for customisation when compared with NetlifyCMS.
+
+Fortunately, the site is more portable now than it was, or would have been with a dynamic CMS like WordPress, or a fully hosted service like SquareSpace. It should be comparatively easy to swap the publishing functions from Forestry to NetlifyCMS or to change the templates. No part of the pipe-line is tightly coupled, the hosting, the CMS and the templates and the build process can all be updated independently, without changing anything else.
+
+We have complete control over the design and mark-up produced. This means we can implement a better responsive design and have a stronger focus on accessibility and performance.
+
+These technology choices gave us a good performance baseline. It was important to implement a site that took advantage of this. As a data visualisation agency, it can be difficult to optimise for performance with a small bundle size, while also aiming for high-quality visuals and working with large datasets. This meant we spent a lot of time optimising assets making sure there was little blocking the critical path for faster rendering and lazy-load images and videos.
+
+The end result is a high performance site. We think this could have been achieved with GatsbyJS, Hugo or any another static site generator. However, what was important was the decision to use static infrastructure for speed, security, flexibility and hopefully a better ongoing development experience. If you are looking at choosing a static site generator or wondering whether a static is the right choice for you, we hope this has helped.
diff --git a/docs/content/templates/data-templates.md b/docs/content/templates/data-templates.md
index 5eac66a97..385bd10a8 100644
--- a/docs/content/templates/data-templates.md
+++ b/docs/content/templates/data-templates.md
@@ -81,7 +81,7 @@ You can now render the list of recordings for all the bass players in a template
{{ end }}
```
-And then in the `partial/artist.html`:
+And then in the `partials/artist.html`:
```
<ul>
diff --git a/docs/content/templates/lists.md b/docs/content/templates/lists.md
index 85de5fe09..a7462317f 100644
--- a/docs/content/templates/lists.md
+++ b/docs/content/templates/lists.md
@@ -43,15 +43,7 @@ The idea of a list page comes from the [hierarchical mental model of the web][me
Since section lists and taxonomy lists (N.B., *not* [taxonomy terms lists][taxterms]) are both *lists* with regards to their templates, both have the same terminating default of `_default/list.html` or `themes/<THEME>/layouts/_default/list.html` in their lookup order. In addition, both [section lists][sectiontemps] and [taxonomy lists][taxlists] have their own default list templates in `_default`:
-#### Default Section Templates
-
-1. `layouts/_default/section.html`
-2. `layouts/_default/list.html`
-
-#### Default Taxonomy List Templates
-
-1. `layouts/_default/taxonomy.html`
-2. `themes/<THEME>/layouts/_default/taxonomy.html`
+See [Template Lookup Order](/templates/lookup-order/) for the complete reference.
## Add Content and Front Matter to List Pages
diff --git a/docs/content/templates/rss.md b/docs/content/templates/rss.md
index f68a2e104..9acbeea47 100644
--- a/docs/content/templates/rss.md
+++ b/docs/content/templates/rss.md
@@ -20,7 +20,7 @@ toc: true
## RSS Template Lookup Order
-See [Template Lookup](/templates/lookup-order/).
+See [Template Lookup Order](/templates/lookup-order/) for the complete reference.
{{% note "Hugo Ships with an RSS Template" %}}
Hugo ships with its own [RSS 2.0 template](#the-embedded-rss-xml). The embedded template will be sufficient for most use cases.
@@ -36,27 +36,9 @@ Hugo provides the ability for you to define any RSS type you wish and can have d
## Lookup Order for RSS Templates
-### Main RSS
+The table below shows the RSS template lookup order for the different page kinds. The first listing shows the lookup order when running with a theme (`demoTheme`).
-1. `/layouts/rss.xml`
-2. `/layouts/_default/rss.xml`
-3. Embedded rss.xml
-
-### Section RSS
-
-1. `/layouts/section/<SECTION>.rss.xml`
-2. `/layouts/_default/rss.xml`
-3. `/themes/<THEME>/layouts/section/<SECTION>.rss.xml`
-4. `/themes/<THEME>/layouts/_default/rss.xml`
-5. Embedded rss.xml
-
-### Taxonomy RSS
-
-1. `/layouts/taxonomy/<SINGULAR>.rss.xml`
-2. `/layouts/_default/rss.xml`
-3. `/themes/<THEME>/layouts/taxonomy/<SINGULAR>.rss.xml`
-4. `/themes/<THEME>/layouts/_default/rss.xml`
-5. Embedded rss.xml
+{{< datatable-filtered "output" "layouts" "OutputFormat == RSS" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
## Configure RSS
@@ -64,7 +46,7 @@ By default, Hugo will create an unlimited number of RSS entries. You can limit t
The following values will also be included in the RSS output if specified in your site’s configuration:
-```
+```toml
languageCode = "en-us"
copyright = "This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License."
@@ -76,7 +58,7 @@ copyright = "This work is licensed under a Creative Commons Attribution-ShareAli
This is the default RSS template that ships with Hugo. It adheres to the [RSS 2.0 Specification][RSS 2.0].
-```
+```xml
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
<title>{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}</title>
@@ -114,26 +96,24 @@ Hugo will automatically add the following header line to this file on render. Pl
## Reference your RSS Feed in `<head>`
-In your `header.html` template, you can specify your RSS feed in your `<head></head>` tag like this:
+In your `header.html` template, you can specify your RSS feed in your `<head></head>` tag using Hugo's [Output Formats][Output Formats] like this:
```
-{{ if .RSSLink }}
- <link href="{{ .RSSLink }}" rel="alternate" type="application/rss+xml" title="{{ .Site.Title }}" />
- <link href="{{ .RSSLink }}" rel="feed" type="application/rss+xml" title="{{ .Site.Title }}" />
-{{ end }}
+{{ range .AlternativeOutputFormats -}}
+ <link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink | safeURL }}" title="{{ $.Site.Title }}">
+{{ end -}}
```
-...with the auto-discovery link specified by the line with `rel="alternate"`.
-
-The `.RSSLink` will render the appropriate RSS feed URL for the section, whether it's everything, posts in a section, or a taxonomy.
-
-If you reference your RSS link, be sure to specify the MIME type with `type="application/rss+xml"`.
+If you only want the RSS link, you can query the formats:
```
-<a href="{{ .URL }}" type="application/rss+xml" target="_blank">{{ .SomeText }}</a>
+{{ with .OutputFormats.Get "rss" -}}
+ <link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink | safeURL }}" title="{{ $.Site.Title }}">
+{{ end -}
```
-
+
[config]: /getting-started/configuration/
[embedded]: #the-embedded-rss-xml
[RSS 2.0]: http://cyber.law.harvard.edu/rss/rss.html "RSS 2.0 Specification"
[section]: /content-management/sections/
+[Output Formats]: /templates/output-formats/#link-to-output-formats \ No newline at end of file
diff --git a/docs/content/tools/search.md b/docs/content/tools/search.md
index d39665130..4d5779b9b 100644
--- a/docs/content/tools/search.md
+++ b/docs/content/tools/search.md
@@ -20,10 +20,10 @@ toc: true
A static website with a dynamic search function? Yes. As alternatives to embeddable scripts from Google or other search engines, you can provide your visitors a custom search by indexing your content files directly.
-* [Hugoidx](https://github.com/blevesearch/hugoidx) is an experimental application to create a search index. It's built on top of [Bleve](http://www.blevesearch.com/).
* [GitHub Gist for Hugo Workflow](https://gist.github.com/sebz/efddfc8fdcb6b480f567). This gist contains a simple workflow to create a search index for your static website. It uses a simple Grunt script to index all your content files and [lunr.js](http://lunrjs.com/) to serve the search results.
* [hugo-lunr](https://www.npmjs.com/package/hugo-lunr). A simple way to add site search to your static Hugo site using [lunr.js](http://lunrjs.com/). Hugo-lunr will create an index file of any html and markdown documents in your Hugo project.
* [hugo-lunr-zh](https://www.npmjs.com/package/hugo-lunr-zh). A bit like Hugo-lunr, but Hugo-lunr-zh can help you seperate the Chinese keywords.
+* [Github Gist for Fuse.js integration](https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae). This gist demonstrates how to leverage Hugo's existing build time processing to generate a searchable JSON index used by [Fuse.js](http://fusejs.io/) on the client side. Although this gist uses Fuse.js for fuzzy matching, any client side search tool capable of reading JSON indexes will work. Does not require npm, grunt or other build-time tools except Hugo!
## Commercial Search Services
diff --git a/docs/content/troubleshooting/faq.md b/docs/content/troubleshooting/faq.md
index a66493cfa..392d7a8df 100644
--- a/docs/content/troubleshooting/faq.md
+++ b/docs/content/troubleshooting/faq.md
@@ -17,6 +17,10 @@ aliases: [/faq/]
**Note:** The answers/solutions presented below are short, and may not be note be enough to solve your problem. Visit [Hugo Discourse](https://discourse.gohugo.io/) and use the search. It that does not help, start a new topic and ask your questions.
{{% /note %}}
+## Can I set configuration variables via OS environment?
+
+Yes you can! See [Configure with Environment Variables](/getting-started/configuration/#configure-with-environment-variables).
+
## How do I schedule posts?
1. Set `publishDate` in the page [Front Matter](/content-management/front-matter/) to a date in the future.
@@ -34,4 +38,3 @@ Also see this Twitter thread:
## Can I use the latest Hugo version on Netlify?
Yes you can! Read [this](/hosting-and-deployment/hosting-on-netlify/#configure-hugo-version-in-netlify).
-
diff --git a/docs/content/variables/taxonomy.md b/docs/content/variables/taxonomy.md
index 1cfa56c51..5bcdffee5 100644
--- a/docs/content/variables/taxonomy.md
+++ b/docs/content/variables/taxonomy.md
@@ -25,7 +25,7 @@ toc: true
For example, the following fields would be available in `layouts/_defaults/terms.html`, depending on how you organize your [taxonomy templates][taxonomytemplates]:
.Data.Singular
-: The singular name of the taxonomy (e.g., `tags => `tag`)
+: The singular name of the taxonomy (e.g., `tags => tag`)
.Data.Plural
: The plural name of the taxonomy (e.g., `tags => tags`)
@@ -49,7 +49,7 @@ Note that `.Data.Terms.Alphabetical` and `.Data.Terms.ByCount` can also be rever
## Use `.Site.Taxonomies` Outside of Taxonomy Templates
-The `.Site.Taxonomies` variable holds all the taxonomies defined site-wide. `.Site.Taxonomies` is a map of the taxonomy name to a list of its values (e.g., `"tags" -> ["tag1", "tag2", "tag3"]``). Each value, though, is not a string but rather a *Taxonomy variable*.
+The `.Site.Taxonomies` variable holds all the taxonomies defined site-wide. `.Site.Taxonomies` is a map of the taxonomy name to a list of its values (e.g., `"tags" -> ["tag1", "tag2", "tag3"]`). Each value, though, is not a string but rather a *Taxonomy variable*.
## The `.Taxonomy` Variable
@@ -81,4 +81,4 @@ The following [partial template][partials] will list all your site's taxonomies,
{{< /code >}}
[partials]: /templates/partials/
-[taxonomytemplates]: /templates/taxonomy-templates/ \ No newline at end of file
+[taxonomytemplates]: /templates/taxonomy-templates/
diff --git a/docs/data/docs.json b/docs/data/docs.json
index 7b9a85d31..641d32818 100644
--- a/docs/data/docs.json
+++ b/docs/data/docs.json
@@ -297,12 +297,6 @@
"OutputFormat": "HTML",
"Suffix": "html",
"Template Lookup Order": [
- "layouts/page/index.html.html",
- "layouts/page/home.html.html",
- "layouts/page/list.html.html",
- "layouts/page/index.html",
- "layouts/page/home.html",
- "layouts/page/list.html",
"layouts/index.html.html",
"layouts/home.html.html",
"layouts/list.html.html",
@@ -349,14 +343,6 @@
"OutputFormat": "HTML",
"Suffix": "html",
"Template Lookup Order": [
- "layouts/page/demolayout.html.html",
- "layouts/page/index.html.html",
- "layouts/page/home.html.html",
- "layouts/page/list.html.html",
- "layouts/page/demolayout.html",
- "layouts/page/index.html",
- "layouts/page/home.html",
- "layouts/page/list.html",
"layouts/demolayout.html.html",
"layouts/index.html.html",
"layouts/home.html.html",
@@ -381,18 +367,6 @@
"OutputFormat": "HTML",
"Suffix": "html",
"Template Lookup Order": [
- "layouts/page/index.html.html",
- "demoTheme/layouts/page/index.html.html",
- "layouts/page/home.html.html",
- "demoTheme/layouts/page/home.html.html",
- "layouts/page/list.html.html",
- "demoTheme/layouts/page/list.html.html",
- "layouts/page/index.html",
- "demoTheme/layouts/page/index.html",
- "layouts/page/home.html",
- "demoTheme/layouts/page/home.html",
- "layouts/page/list.html",
- "demoTheme/layouts/page/list.html",
"layouts/index.html.html",
"demoTheme/layouts/index.html.html",
"layouts/home.html.html",
@@ -425,18 +399,6 @@
"OutputFormat": "AMP",
"Suffix": "html",
"Template Lookup Order": [
- "layouts/page/index.fr.amp.html",
- "layouts/page/home.fr.amp.html",
- "layouts/page/list.fr.amp.html",
- "layouts/page/index.amp.html",
- "layouts/page/home.amp.html",
- "layouts/page/list.amp.html",
- "layouts/page/index.fr.html",
- "layouts/page/home.fr.html",
- "layouts/page/list.fr.html",
- "layouts/page/index.html",
- "layouts/page/home.html",
- "layouts/page/list.html",
"layouts/index.fr.amp.html",
"layouts/home.fr.amp.html",
"layouts/list.fr.amp.html",
@@ -469,12 +431,6 @@
"OutputFormat": "JSON",
"Suffix": "json",
"Template Lookup Order": [
- "layouts/page/index.json.json",
- "layouts/page/home.json.json",
- "layouts/page/list.json.json",
- "layouts/page/index.json",
- "layouts/page/home.json",
- "layouts/page/list.json",
"layouts/index.json.json",
"layouts/home.json.json",
"layouts/list.json.json",
@@ -490,31 +446,136 @@
]
},
{
- "Example": "RSS home",
+ "Example": "RSS home with theme",
"Kind": "home",
"OutputFormat": "RSS",
"Suffix": "xml",
"Template Lookup Order": [
- "layouts/page/index.rss.xml",
- "layouts/page/home.rss.xml",
- "layouts/page/rss.xml",
- "layouts/page/list.rss.xml",
- "layouts/page/index.xml",
- "layouts/page/home.xml",
- "layouts/page/list.xml",
"layouts/index.rss.xml",
+ "demoTheme/layouts/index.rss.xml",
"layouts/home.rss.xml",
+ "demoTheme/layouts/home.rss.xml",
"layouts/rss.xml",
+ "demoTheme/layouts/rss.xml",
"layouts/list.rss.xml",
+ "demoTheme/layouts/list.rss.xml",
"layouts/index.xml",
+ "demoTheme/layouts/index.xml",
"layouts/home.xml",
+ "demoTheme/layouts/home.xml",
"layouts/list.xml",
+ "demoTheme/layouts/list.xml",
"layouts/_default/index.rss.xml",
+ "demoTheme/layouts/_default/index.rss.xml",
"layouts/_default/home.rss.xml",
+ "demoTheme/layouts/_default/home.rss.xml",
"layouts/_default/rss.xml",
+ "demoTheme/layouts/_default/rss.xml",
"layouts/_default/list.rss.xml",
+ "demoTheme/layouts/_default/list.rss.xml",
"layouts/_default/index.xml",
+ "demoTheme/layouts/_default/index.xml",
"layouts/_default/home.xml",
+ "demoTheme/layouts/_default/home.xml",
+ "layouts/_default/list.xml",
+ "demoTheme/layouts/_default/list.xml",
+ "layouts/_internal/_default/rss.xml"
+ ]
+ },
+ {
+ "Example": "RSS section posts",
+ "Kind": "section",
+ "OutputFormat": "RSS",
+ "Suffix": "xml",
+ "Template Lookup Order": [
+ "layouts/posts/section.rss.xml",
+ "layouts/posts/rss.xml",
+ "layouts/posts/list.rss.xml",
+ "layouts/posts/section.xml",
+ "layouts/posts/list.xml",
+ "layouts/section/section.rss.xml",
+ "layouts/section/rss.xml",
+ "layouts/section/list.rss.xml",
+ "layouts/section/section.xml",
+ "layouts/section/list.xml",
+ "layouts/_default/section.rss.xml",
+ "layouts/_default/rss.xml",
+ "layouts/_default/list.rss.xml",
+ "layouts/_default/section.xml",
+ "layouts/_default/list.xml",
+ "layouts/_internal/_default/rss.xml"
+ ]
+ },
+ {
+ "Example": "Taxonomy list in categories",
+ "Kind": "taxonomy",
+ "OutputFormat": "RSS",
+ "Suffix": "xml",
+ "Template Lookup Order": [
+ "layouts/categories/category.rss.xml",
+ "layouts/categories/taxonomy.rss.xml",
+ "layouts/categories/rss.xml",
+ "layouts/categories/list.rss.xml",
+ "layouts/categories/category.xml",
+ "layouts/categories/taxonomy.xml",
+ "layouts/categories/list.xml",
+ "layouts/taxonomy/category.rss.xml",
+ "layouts/taxonomy/taxonomy.rss.xml",
+ "layouts/taxonomy/rss.xml",
+ "layouts/taxonomy/list.rss.xml",
+ "layouts/taxonomy/category.xml",
+ "layouts/taxonomy/taxonomy.xml",
+ "layouts/taxonomy/list.xml",
+ "layouts/category/category.rss.xml",
+ "layouts/category/taxonomy.rss.xml",
+ "layouts/category/rss.xml",
+ "layouts/category/list.rss.xml",
+ "layouts/category/category.xml",
+ "layouts/category/taxonomy.xml",
+ "layouts/category/list.xml",
+ "layouts/_default/category.rss.xml",
+ "layouts/_default/taxonomy.rss.xml",
+ "layouts/_default/rss.xml",
+ "layouts/_default/list.rss.xml",
+ "layouts/_default/category.xml",
+ "layouts/_default/taxonomy.xml",
+ "layouts/_default/list.xml",
+ "layouts/_internal/_default/rss.xml"
+ ]
+ },
+ {
+ "Example": "Taxonomy terms in categories",
+ "Kind": "taxonomyTerm",
+ "OutputFormat": "RSS",
+ "Suffix": "xml",
+ "Template Lookup Order": [
+ "layouts/categories/category.terms.rss.xml",
+ "layouts/categories/terms.rss.xml",
+ "layouts/categories/rss.xml",
+ "layouts/categories/list.rss.xml",
+ "layouts/categories/category.terms.xml",
+ "layouts/categories/terms.xml",
+ "layouts/categories/list.xml",
+ "layouts/taxonomy/category.terms.rss.xml",
+ "layouts/taxonomy/terms.rss.xml",
+ "layouts/taxonomy/rss.xml",
+ "layouts/taxonomy/list.rss.xml",
+ "layouts/taxonomy/category.terms.xml",
+ "layouts/taxonomy/terms.xml",
+ "layouts/taxonomy/list.xml",
+ "layouts/category/category.terms.rss.xml",
+ "layouts/category/terms.rss.xml",
+ "layouts/category/rss.xml",
+ "layouts/category/list.rss.xml",
+ "layouts/category/category.terms.xml",
+ "layouts/category/terms.xml",
+ "layouts/category/list.xml",
+ "layouts/_default/category.terms.rss.xml",
+ "layouts/_default/terms.rss.xml",
+ "layouts/_default/rss.xml",
+ "layouts/_default/list.rss.xml",
+ "layouts/_default/category.terms.xml",
+ "layouts/_default/terms.xml",
"layouts/_default/list.xml",
"layouts/_internal/_default/rss.xml"
]
@@ -787,7 +848,12 @@
"Aliases": [
"ge"
],
- "Examples": []
+ "Examples": [
+ [
+ "{{ if ge .Hugo.Version \"0.36\" }}Reasonable new Hugo version!{{ end }}",
+ "Reasonable new Hugo version!"
+ ]
+ ]
},
"Gt": {
"Description": "Gt returns the boolean truth of arg1 \u003e arg2.",
@@ -2238,6 +2304,20 @@
"Hello world, gophers!"
]
]
+ },
+ "Remarshal": {
+ "Description": "Remarshal is used in the Hugo documentation to convert configuration\nexamples from YAML to JSON, TOML (and possibly the other way around).\nThe is primarily a helper for the Hugo docs site.\nIt is not a general purpose YAML to TOML converter etc., and may\nchange without notice if it serves a purpose in the docs.\nFormat is one of json, yaml or toml.",
+ "Args": [
+ "format",
+ "data"
+ ],
+ "Aliases": null,
+ "Examples": [
+ [
+ "{{ \"title = \\\"Hello World\\\"\" | transform.Remarshal \"json\" | safeHTML }}",
+ "{\n \"title\": \"Hello World\"\n}\n"
+ ]
+ ]
}
},
"urls": {
diff --git a/docs/layouts/shortcodes/code.html b/docs/layouts/shortcodes/code.html
index 4c12b0f29..83220c47d 100644
--- a/docs/layouts/shortcodes/code.html
+++ b/docs/layouts/shortcodes/code.html
@@ -1,5 +1,10 @@
{{ $file := .Get "file" }}
-{{ $isHTML := strings.HasSuffix $file "html" }}
+{{ $.Scratch.Set "codeLang" "" }}
+{{ $suffix := findRE "(\\.[^.]+)$" $file 1 }}
+{{ with $suffix }}
+{{ $.Scratch.Set "codeLang" (index . 0 | strings.TrimPrefix ".") }}
+{{ end }}
+{{ with .Get "codeLang" }}{{ $.Scratch.Set "codeLang" . }}{{ end }}
<div class="code relative" id="{{ $file | urlize}}">
{{- with $file -}}
<div class="filename san-serif f6 dib lh-solid pl2 pv2">{{.}}</div>
@@ -11,7 +16,7 @@
{{/* Functionality located within filesaver.js The copy here is located in the css with .copy class so it can be replaced with JS on success */}}
{{end}}
<div class="code-copy-content nt3" {{with .Get "download"}}id="{{.}}"{{end}}>
- {{ if .Get "nocode" }}{{ .Inner }}{{ else }}{{ if $isHTML }}{{- highlight .Inner "html" "" | -}}{{ else }}<pre><code>{{- .Inner | string -}}</code></pre>{{ end }}{{ end }}
+ {{ if .Get "nocode" }}{{ $.Inner }}{{ else }}{{ with $.Scratch.Get "codeLang" }}{{- highlight $.Inner . "" | -}}{{ else }}<pre><code>{{- .Inner | string -}}</code></pre>{{ end }}{{ end }}
</div>
</div>
diff --git a/docs/netlify.toml b/docs/netlify.toml
index 6f21789b2..5955d26cd 100644
--- a/docs/netlify.toml
+++ b/docs/netlify.toml
@@ -3,7 +3,7 @@ publish = "public"
command = "hugo"
[context.production.environment]
-HUGO_VERSION = "0.36.1"
+HUGO_VERSION = "0.37.1"
HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true"
@@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
command = "hugo --enableGitInfo"
[context.split1.environment]
-HUGO_VERSION = "0.36.1"
+HUGO_VERSION = "0.37.1"
HUGO_ENV = "production"
[context.deploy-preview]
command = "hugo -b $DEPLOY_PRIME_URL"
[context.deploy-preview.environment]
-HUGO_VERSION = "0.36.1"
+HUGO_VERSION = "0.37.1"
[context.branch-deploy]
command = "hugo -b $DEPLOY_PRIME_URL"
[context.branch-deploy.environment]
-HUGO_VERSION = "0.36.1"
+HUGO_VERSION = "0.37.1"
[context.next.environment]
HUGO_ENABLEGITINFO = "true"
diff --git a/docs/resources/_gen/images/content-management/organization/1-featured-content-bundles_hu3e3ae7839b071119f32acaa20f204198_63640_300x0_resize_catmullrom.png b/docs/resources/_gen/images/content-management/organization/1-featured-content-bundles_hu3e3ae7839b071119f32acaa20f204198_63640_300x0_resize_catmullrom_2.png
index bc604e562..bc604e562 100644
--- a/docs/resources/_gen/images/content-management/organization/1-featured-content-bundles_hu3e3ae7839b071119f32acaa20f204198_63640_300x0_resize_catmullrom.png
+++ b/docs/resources/_gen/images/content-management/organization/1-featured-content-bundles_hu3e3ae7839b071119f32acaa20f204198_63640_300x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom.png
deleted file mode 100644
index cf00e1cd6..000000000
--- a/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..69284a4d8
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_480x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom.png
deleted file mode 100644
index 37ff457ec..000000000
--- a/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..90877e6ae
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.33-relnotes/featured-hugo-33-poster_hu45ce9da1cdea6ca61c5f4f5baccdcad4_70230_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom.png
deleted file mode 100644
index c2ae4527c..000000000
--- a/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..21fce414d
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_480x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom.png
deleted file mode 100644
index 7788b1fd2..000000000
--- a/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..89e5e9c76
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.34-relnotes/featured-34-poster_hud8d73dc5df8d5a35383849a78eea35dd_78317_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom.png
deleted file mode 100644
index d08624fb8..000000000
--- a/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..370628aec
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_480x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom.png
deleted file mode 100644
index 61197ee1b..000000000
--- a/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..86a93de25
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.35-relnotes/featured-hugo-35-poster_hua42b1310dd72f60a34e02851ebf2f82e_88519_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom.png
deleted file mode 100644
index 0084edfa5..000000000
--- a/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..f57f33902
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_480x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom.png b/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom.png
deleted file mode 100644
index a6dafec1d..000000000
--- a/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..cc9072507
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.36-relnotes/featured-hugo-36-poster_huf2fee368f65c75d3878561ed4225c39a_67640_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_480x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..d0f3670b2
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_480x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..a91566c1e
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.37-relnotes/featured-hugo-37-poster_hue9685d25c387d657b0640498bf6a10ee_186693_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top.png b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top.png
deleted file mode 100644
index 0dd0e8ef6..000000000
--- a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top_2.png b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top_2.png
new file mode 100644
index 000000000..b7399ff8e
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_1024x512_fill_catmullrom_top_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom.png b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom.png
deleted file mode 100644
index 5f7df90b2..000000000
--- a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..e953c86df
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8714c8c914d32c12c7eb833a42713319.png b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8714c8c914d32c12c7eb833a42713319.png
new file mode 100644
index 000000000..d28d99662
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8714c8c914d32c12c7eb833a42713319.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8b32e959be6137399a224ecc56caffb1.png b/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8b32e959be6137399a224ecc56caffb1.png
deleted file mode 100644
index 2221ab06e..000000000
--- a/docs/resources/_gen/images/showcase/1password-support/featured_hu870838c23243880857c2e418dd7ac099_165718_8b32e959be6137399a224ecc56caffb1.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_02c2d5bfbe1f2c621df733e4d040574d.png b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_02c2d5bfbe1f2c621df733e4d040574d.png
deleted file mode 100644
index 9b158b66c..000000000
--- a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_02c2d5bfbe1f2c621df733e4d040574d.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top.png b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top.png
deleted file mode 100644
index 3324816cc..000000000
--- a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top_2.png b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top_2.png
new file mode 100644
index 000000000..020a3f7fa
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_1024x512_fill_catmullrom_top_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom.png b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom.png
deleted file mode 100644
index 3bb21e8f7..000000000
--- a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..d18131eb5
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_a6f43693b7589a8d91c844654967eb51.png b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_a6f43693b7589a8d91c844654967eb51.png
new file mode 100644
index 000000000..319316d00
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/hartwell-insurance/featured_hu642e730c6f819b15fc6ebbaa25b0243f_446603_a6f43693b7589a8d91c844654967eb51.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_1024x512_fill_catmullrom_top.png b/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_1024x512_fill_catmullrom_top_2.png
index 3f5b94403..3f5b94403 100644
--- a/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_1024x512_fill_catmullrom_top.png
+++ b/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_1024x512_fill_catmullrom_top_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_640x0_resize_catmullrom.png b/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_640x0_resize_catmullrom_2.png
index b2d501efb..b2d501efb 100644
--- a/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_640x0_resize_catmullrom.png
+++ b/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_7af7b624b13f6554ad54ee33f84bf08e.png b/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_97b33e8221e700cd517d4ce317c69e48.png
index 9f8b5a918..9f8b5a918 100644
--- a/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_7af7b624b13f6554ad54ee33f84bf08e.png
+++ b/docs/resources/_gen/images/showcase/linode/featured_hu6acc14b2375e47c4c764fef09fdb54c0_126664_97b33e8221e700cd517d4ce317c69e48.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_1024x512_fill_catmullrom_top.png b/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_1024x512_fill_catmullrom_top_2.png
index c295aafad..c295aafad 100644
--- a/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_1024x512_fill_catmullrom_top.png
+++ b/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_1024x512_fill_catmullrom_top_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_640x0_resize_catmullrom.png b/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_640x0_resize_catmullrom_2.png
index 3bb9e2a67..3bb9e2a67 100644
--- a/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_640x0_resize_catmullrom.png
+++ b/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_7e3f008d047fb3522bf02df4e9229522.png b/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_7e3f008d047fb3522bf02df4e9229522.png
new file mode 100644
index 000000000..8d1c41943
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_7e3f008d047fb3522bf02df4e9229522.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_978ff9297dc1d5096773813d2df58a6f.png b/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_978ff9297dc1d5096773813d2df58a6f.png
deleted file mode 100644
index e4eb094af..000000000
--- a/docs/resources/_gen/images/showcase/pace-revenue-management/featured_hu143b6afebcd8780a08aa0a9f8e95dd02_298908_978ff9297dc1d5096773813d2df58a6f.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_1024x512_fill_catmullrom_top.png b/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_1024x512_fill_catmullrom_top_2.png
index 4afe5049c..4afe5049c 100644
--- a/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_1024x512_fill_catmullrom_top.png
+++ b/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_1024x512_fill_catmullrom_top_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_3b6053b86d6afebe8262ece1955ed6cf.png b/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_3b6053b86d6afebe8262ece1955ed6cf.png
new file mode 100644
index 000000000..e9e149400
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_3b6053b86d6afebe8262ece1955ed6cf.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_640x0_resize_catmullrom.png b/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_640x0_resize_catmullrom_2.png
index d8c6222d1..d8c6222d1 100644
--- a/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_640x0_resize_catmullrom.png
+++ b/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_9a216d034e8628dd139a6a7fa62712b4.png b/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_9a216d034e8628dd139a6a7fa62712b4.png
deleted file mode 100644
index 39b1ff1df..000000000
--- a/docs/resources/_gen/images/showcase/quiply-employee-communications-app/featured_hua0e0d1ed0f0bc15921e78476b0c86c95_631206_9a216d034e8628dd139a6a7fa62712b4.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top.png b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top.png
deleted file mode 100644
index 6ff6a912f..000000000
--- a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top_2.png b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top_2.png
new file mode 100644
index 000000000..4041d28df
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_1024x512_fill_catmullrom_top_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_5f4044a9cb8ece7d6e61bd0e0fb32a0d.png b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_5f4044a9cb8ece7d6e61bd0e0fb32a0d.png
deleted file mode 100644
index 7e87c0a5a..000000000
--- a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_5f4044a9cb8ece7d6e61bd0e0fb32a0d.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom.png b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom.png
deleted file mode 100644
index 7a0cab5e3..000000000
--- a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..7dbd463bb
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_671a5c232ffa27a2cf198d2c39f253eb.png b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_671a5c232ffa27a2cf198d2c39f253eb.png
new file mode 100644
index 000000000..d27a44e98
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/stackimpact/featured_hu863cdba7b6e18bb95f64289a25912f5c_153794_671a5c232ffa27a2cf198d2c39f253eb.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_0be9b039f9029effab69b9239e224cf7.png b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_0be9b039f9029effab69b9239e224cf7.png
new file mode 100644
index 000000000..0026f811e
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_0be9b039f9029effab69b9239e224cf7.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top.png b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top.png
deleted file mode 100644
index aac9edb66..000000000
--- a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top_2.png b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top_2.png
new file mode 100644
index 000000000..10265e45e
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_1024x512_fill_catmullrom_top_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_34aaa1bbe5cc1b4798bfff8f28e1033e.png b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_34aaa1bbe5cc1b4798bfff8f28e1033e.png
deleted file mode 100644
index fe56cdfbe..000000000
--- a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_34aaa1bbe5cc1b4798bfff8f28e1033e.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom.png b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom.png
deleted file mode 100644
index 1bf56b67b..000000000
--- a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom.png
+++ /dev/null
Binary files differ
diff --git a/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..a58f0b78c
--- /dev/null
+++ b/docs/resources/_gen/images/showcase/template/featured-template_hu2f0d11388f944348b232a431caeb965b_41270_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/themes/gohugoioTheme/data/sponsors.toml b/docs/themes/gohugoioTheme/data/sponsors.toml
index 03e89745f..5e35a25dc 100644
--- a/docs/themes/gohugoioTheme/data/sponsors.toml
+++ b/docs/themes/gohugoioTheme/data/sponsors.toml
@@ -5,9 +5,9 @@ logo = "/images/sponsors/forestry-logotype.svg"
copy = ""
[[banners]]
-name = ""
-link = ""
-logo = ""
+name = "Linode"
+link = "https://www.linode.com/"
+logo = "/images/sponsors/linode-logo_standard_light_medium.png"
copy = ""
[[banners]]
diff --git a/docs/themes/gohugoioTheme/layouts/partials/gtag.html b/docs/themes/gohugoioTheme/layouts/partials/gtag.html
index b89f2feb1..c78926503 100644
--- a/docs/themes/gohugoioTheme/layouts/partials/gtag.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/gtag.html
@@ -5,7 +5,8 @@
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
- gtag('config', '{{ . }}');
+ {{ $site := $.Site.BaseURL | replaceRE "^https?://(www\\.)?([^/]+).*" "$2" }}
+ gtag('config', '{{ . }}', {'dimension1': '{{ $site }}', 'dimension2': '{{ getenv "BRANCH" }}'});
/**
* Function that tracks a click on an outbound link in Analytics.
@@ -13,7 +14,6 @@
* using 'navigator.sendBeacon' in browser that support it.
*/
var trackOutboundLink = function(id, url) {
- console.log("track:", id, url)
gtag('event', 'click', {
'event_category': 'outbound',
'event_label': id,
diff --git a/docs/static/images/gopher-side_color.svg b/docs/themes/gohugoioTheme/static/images/gopher-side_color.svg
index 85f949783..85f949783 100755
--- a/docs/static/images/gopher-side_color.svg
+++ b/docs/themes/gohugoioTheme/static/images/gopher-side_color.svg
diff --git a/docs/themes/gohugoioTheme/static/images/sponsors/forestry-logotype.svg b/docs/themes/gohugoioTheme/static/images/sponsors/forestry-logotype.svg
index ed28d6994..ac95cd444 100644
--- a/docs/themes/gohugoioTheme/static/images/sponsors/forestry-logotype.svg
+++ b/docs/themes/gohugoioTheme/static/images/sponsors/forestry-logotype.svg
@@ -1 +1 @@
-<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 296.5 76"><style>.st0{fill:none;}</style><path class="st0" d="M198 53.5c.3-.3.4-.8.4-1.4 0-.5-.1-.9-.3-1.3-.2-.3-.5-.6-.8-.7-.3-.2-.7-.3-1.1-.3-.4-.1-.8-.1-1.3-.1h-2.5v4.9h3.1c.5 0 1-.1 1.4-.3.4-.3.8-.5 1.1-.8zM29.5 34.7l-5-9.6c-.5-1-1.9-1-2.4 0L15 38.7c-.5.9.2 2 1.2 2H22v2.1c0 .5.4.9.9.9h.9c.5 0 .9-.4.9-.9v-2.1h1.7l3.1-6zM184.4 51c-.5-.6-1.1-1-1.8-1.3-.7-.3-1.5-.5-2.4-.5-.9 0-1.6.2-2.4.5-.7.3-1.3.8-1.8 1.3-.5.6-.9 1.2-1.2 1.9-.3.7-.4 1.5-.4 2.4s.1 1.6.4 2.4c.3.7.7 1.4 1.2 1.9.5.6 1.1 1 1.8 1.3.7.3 1.5.5 2.4.5.9 0 1.6-.2 2.4-.5.7-.3 1.3-.8 1.8-1.3s.9-1.2 1.2-1.9c.3-.7.4-1.5.4-2.4s-.1-1.6-.4-2.4c-.3-.6-.7-1.3-1.2-1.9zM121.4 31.6c4.2 0 6.4-2.8 6.4-8.4 0-5.6-2.1-8.5-6.3-8.5-2.1 0-3.7.7-4.8 2.1-1.1 1.4-1.6 3.5-1.6 6.3s.5 4.9 1.6 6.3c1 1.5 2.6 2.2 4.7 2.2zM151.3 15.8c-.8-.5-2.1-.8-3.8-.8h-1.6v6.8h1.7c1.7 0 2.9-.3 3.7-.8.8-.6 1.2-1.4 1.2-2.6.1-1.2-.4-2.1-1.2-2.6zM96 50.3l-3.1 7.2H99l-3-7.2zM242.1 15.8c-.8-.5-2.1-.8-3.8-.8h-1.6v6.8h1.7c1.7 0 2.9-.3 3.7-.8.8-.6 1.2-1.4 1.2-2.6.1-1.2-.3-2.1-1.2-2.6zM39.5 24.9c-.3-.5-.7-.7-1.2-.7s-.9.2-1.2.7L26.2 45.7c-.5.9.2 2 1.2 2h8.9V51c0 .5.4.9.9.9h2.3c.5 0 .9-.4.9-.9v-3.3h8.9c1 0 1.7-1.1 1.2-2l-11-20.8zM291.4 15.3c-.8 0-1.3.3-1.7.8-.3.5-.5 1.2-.5 2.2 0 2 .7 3 2.2 3 1.5 0 2.2-1 2.2-3s-.7-3-2.2-3zM266 51c-.5-.6-1.1-1-1.8-1.3-.7-.3-1.5-.5-2.4-.5-.9 0-1.6.2-2.4.5-.7.3-1.3.8-1.8 1.3-.5.6-.9 1.2-1.2 1.9-.3.7-.4 1.5-.4 2.4s.1 1.6.4 2.4c.3.7.7 1.4 1.2 1.9.5.6 1.1 1 1.8 1.3.7.3 1.5.5 2.4.5.9 0 1.6-.2 2.4-.5.7-.3 1.3-.8 1.8-1.3s.9-1.2 1.2-1.9c.3-.7.4-1.5.4-2.4s-.1-1.6-.4-2.4c-.3-.6-.7-1.3-1.2-1.9z"/><path d="M89.3 35.8h5.2v-9.9h8.5v-4.4h-8.5v-6.4h9.1v-4.4H89.3zM121.4 36.1c3.8 0 6.8-1.1 8.8-3.3 2.1-2.2 3.1-5.4 3.1-9.6 0-4.2-1-7.3-3.1-9.6-2-2.2-5-3.3-8.8-3.3s-6.8 1.1-8.9 3.3c-2.1 2.2-3.1 5.4-3.1 9.5s1 7.4 3.1 9.6c2.1 2.3 5.1 3.4 8.9 3.4zm-4.7-19.2c1.1-1.4 2.7-2.1 4.8-2.1 4.2 0 6.3 2.8 6.3 8.5 0 5.6-2.1 8.4-6.4 8.4-2.1 0-3.7-.7-4.8-2.1-1.1-1.4-1.6-3.5-1.6-6.3s.6-5 1.7-6.4zM156.7 22.2c.8-1.1 1.2-2.5 1.2-3.9 0-2.5-.8-4.4-2.4-5.6s-4.1-1.9-7.5-1.9h-7.3v25h5.3v-9.6h2.8l6 9.6h5.9c-1.1-1.6-3.6-5.3-7.4-10.9 1.4-.7 2.6-1.6 3.4-2.7zm-5.3-1.2c-.8.6-2 .8-3.7.8H146V15h1.6c1.7 0 3 .3 3.8.8.8.5 1.2 1.3 1.2 2.5 0 1.3-.4 2.1-1.2 2.7zM180.3 31.4h-9.1v-5.5h8.5v-4.4h-8.5v-6.4h9.1v-4.4h-14.4v25.1h14.4zM196.3 21.3c-1.8-.8-2.9-1.4-3.4-1.8-.5-.3-.8-.7-1-1-.2-.3-.3-.8-.3-1.2 0-.8.3-1.4.8-1.8.5-.5 1.3-.7 2.3-.7.8 0 1.7.1 2.6.3.9.2 2 .6 3.3 1.1l1.7-4.1c-1.3-.6-2.5-1-3.7-1.3-1.2-.3-2.4-.5-3.7-.5-2.6 0-4.7.6-6.2 1.9-1.5 1.3-2.3 3-2.3 5.2 0 1.2.2 2.2.7 3.1s1.1 1.6 1.8 2.3c.8.7 1.9 1.4 3.4 2.1 1.6.8 2.7 1.3 3.2 1.7.5.4.9.7 1.2 1.1.3.4.4.8.4 1.3 0 .9-.3 1.5-.9 2-.6.4-1.5.7-2.7.7-1 0-2-.2-3.2-.5-1.2-.3-2.6-.8-4.3-1.6v4.9c2.1 1 4.4 1.5 7.1 1.5 2.9 0 5.2-.7 6.8-2 1.6-1.3 2.4-3.1 2.4-5.3 0-1.6-.4-3-1.3-4.1-.8-1.1-2.4-2.2-4.7-3.3zM213.4 35.8h5.3V15.1h6.8v-4.4h-18.9v4.4h6.8zM247.5 22.2c.8-1.1 1.2-2.5 1.2-3.9 0-2.5-.8-4.4-2.4-5.6-1.6-1.2-4.1-1.9-7.5-1.9h-7.3v25h5.3v-9.6h2.8l6 9.6h5.9c-1.1-1.6-3.6-5.3-7.4-10.9 1.4-.7 2.6-1.6 3.4-2.7zm-5.3-1.2c-.8.6-2 .8-3.7.8h-1.7V15h1.6c1.7 0 3 .3 3.8.8.8.5 1.2 1.3 1.2 2.5 0 1.3-.4 2.1-1.2 2.7zM264.5 21l-5.2-10.3h-5.8l8.3 15.5v9.6h5.3V26l8.3-15.3h-5.7zM282.4 14h1.8v8.7h-1.8zM283.3 10.6c-.3 0-.6.1-.8.3-.2.2-.3.4-.3.8 0 .3.1.6.3.7s.4.3.8.3c.3 0 .6-.1.8-.3s.3-.4.3-.7c0-.3-.1-.6-.3-.8-.2-.2-.5-.3-.8-.3zM294.4 15c-.7-.8-1.7-1.2-3-1.2s-2.3.4-3 1.2c-.7.8-1.1 1.9-1.1 3.3 0 .9.2 1.7.5 2.4s.8 1.2 1.4 1.6c.6.4 1.3.5 2.1.5 1.3 0 2.3-.4 3-1.2.7-.8 1.1-1.9 1.1-3.3.1-1.4-.3-2.5-1-3.3zm-3 6.3c-1.5 0-2.2-1-2.2-3 0-1 .2-1.7.5-2.2.3-.5.9-.8 1.7-.8 1.5 0 2.2 1 2.2 3s-.7 3-2.2 3zM62.9 18L34.4 1.5c-1.1-.6-2.5-.6-3.6 0L2.3 18c-1.1.6-1.8 1.8-1.8 3.1v33c0 1.3.7 2.5 1.8 3.1l28.5 16.5c1.1.6 2.5.6 3.6 0l28.5-16.5c1.1-.6 1.8-1.8 1.8-3.1v-33c0-1.3-.7-2.5-1.8-3.1zM24.6 42.7c0 .5-.4.9-.9.9h-.9c-.5 0-.9-.4-.9-.9v-2.1h-5.8c-1 0-1.7-1.1-1.2-2L22 25c.5-1 1.9-1 2.4 0l5 9.6-3.1 6h-1.7v2.1zm24.6 5h-8.9V51c0 .5-.4.9-.9.9h-2.3c-.5 0-.9-.4-.9-.9v-3.3h-8.9c-1 0-1.7-1.1-1.2-2L37 24.9c.3-.5.7-.7 1.2-.7s.9.2 1.2.7l10.9 20.8c.5.9-.1 2-1.1 2zM95.3 48l-6.5 14.7h2l1.5-3.6h7.4l1.5 3.6h2L96.9 48h-1.6zm-2.4 9.5l3.1-7.2 2.9 7.2h-6zM119.9 61c-.7.4-1.5.5-2.4.5-.8 0-1.6-.2-2.3-.5-.7-.3-1.3-.8-1.8-1.3s-.9-1.2-1.2-1.9c-.3-.7-.4-1.5-.4-2.4 0-.8.1-1.6.4-2.3.3-.7.7-1.4 1.2-2 .5-.6 1.1-1 1.8-1.3.7-.3 1.4-.5 2.3-.5.7 0 1.4.1 2 .4.7.3 1.2.7 1.6 1.3l1.5-1.1c-.6-.8-1.4-1.4-2.3-1.8s-1.9-.5-2.9-.5c-1.1 0-2.1.2-3 .6s-1.7.9-2.4 1.6c-.7.7-1.2 1.5-1.5 2.5-.4.9-.6 2-.6 3 0 1.1.2 2.2.6 3.1.4.9.9 1.8 1.6 2.4.7.7 1.5 1.2 2.4 1.6s1.9.6 3 .6c1.2 0 2.2-.2 3.2-.6.9-.4 1.7-1.1 2.4-2l-1.3-1.1c-.5.8-1.1 1.3-1.9 1.7zM133.2 59.6h-.1l-5-11.6h-2.6v14.7h1.8V50.4l5.3 12.3h1.1l5.3-12.3v12.3h1.7V48h-2.5zM151.7 55.8c-.4-.3-.9-.6-1.4-.8-.5-.2-1.1-.4-1.7-.6-.6-.2-1.1-.4-1.5-.5-.4-.2-.7-.4-1-.6s-.4-.4-.5-.7c-.1-.3-.2-.6-.2-.9 0-.4.1-.8.3-1.1.2-.3.4-.6.7-.8.3-.2.6-.3 1-.4.4-.1.8-.1 1.1-.1.5 0 1 .1 1.5.3.5.2.9.6 1.2 1l1.4-1.2c-.5-.6-1.2-1.1-1.8-1.3-.7-.3-1.4-.4-2.3-.4-.7 0-1.3.1-1.9.3-.6.2-1.1.4-1.6.8s-.8.8-1.1 1.3c-.3.5-.4 1.1-.4 1.9 0 .6.1 1.1.3 1.6.2.4.4.8.8 1.1.3.3.7.6 1.2.8s.9.4 1.5.6c.7.2 1.2.4 1.7.6.5.2.9.4 1.2.6.3.2.6.5.7.7.2.3.2.7.2 1.1 0 .4-.1.8-.3 1.1-.2.3-.4.6-.7.8-.3.2-.6.4-1 .5-.4.1-.8.2-1.1.2-.6 0-1.2-.1-1.8-.4s-1-.7-1.3-1.2l-1.5 1.2c.2.4.5.7.9.9.3.3.7.5 1.1.6.4.2.8.3 1.2.4s.9.1 1.3.1c.7 0 1.3-.1 1.9-.3s1.2-.4 1.7-.8.9-.8 1.2-1.3c.3-.5.4-1.2.4-1.9s-.1-1.3-.4-1.8c-.2-.7-.6-1.1-1-1.4zM161.7 62.7h1.8v-6.6h6.9v-1.6h-6.9v-4.9h7.4V48h-9.2zM185.7 49.8c-.7-.7-1.5-1.2-2.4-1.6-.9-.4-2-.6-3.1-.6s-2.2.2-3.1.6c-.9.4-1.7.9-2.4 1.6-.7.7-1.2 1.5-1.6 2.5-.4.9-.6 2-.6 3.1s.2 2.1.6 3.1c.4.9.9 1.8 1.6 2.5.7.7 1.5 1.2 2.4 1.6s2 .6 3.1.6 2.2-.2 3.1-.6 1.7-.9 2.4-1.6c.7-.7 1.2-1.5 1.6-2.5.4-1 .6-2 .6-3.1s-.2-2.1-.6-3.1c-.4-1-.9-1.8-1.6-2.5zm-.2 8c-.3.7-.7 1.4-1.2 1.9s-1.1 1-1.8 1.3c-.7.3-1.5.5-2.4.5-.9 0-1.6-.2-2.4-.5-.7-.3-1.3-.8-1.8-1.3-.5-.6-.9-1.2-1.2-1.9-.3-.7-.4-1.5-.4-2.4s.1-1.6.4-2.4c.3-.7.7-1.4 1.2-1.9.5-.6 1.1-1 1.8-1.3.7-.3 1.5-.5 2.4-.5.9 0 1.6.2 2.4.5.7.3 1.3.8 1.8 1.3s.9 1.2 1.2 1.9c.3.7.4 1.5.4 2.4s-.1 1.6-.4 2.4zM199.3 54.7c.7-.7 1-1.5 1-2.6 0-.9-.2-1.6-.5-2.2-.3-.5-.8-.9-1.4-1.2s-1.2-.5-1.9-.5-1.4-.1-2.1-.1h-3.8v14.7h1.7v-6.6h2.2l4 6.6h2.1l-4.2-6.8c1.3-.2 2.3-.6 2.9-1.3zm-5.3-.2h-1.6v-4.9h2.5c.4 0 .9 0 1.3.1s.8.2 1.1.3c.3.2.6.4.8.7.2.3.3.7.3 1.3 0 .6-.1 1.1-.4 1.4-.3.3-.6.6-1.1.7-.4.2-.9.2-1.4.3-.6.1-1.1.1-1.5.1zM218.7 54.3h-7.8V48h-1.8v14.7h1.8v-6.8h7.8v6.8h1.8V48h-1.8zM233.5 56.9c0 .6-.1 1.2-.2 1.7-.1.6-.3 1-.6 1.5s-.7.8-1.2 1c-.5.3-1.1.4-1.8.4s-1.3-.1-1.8-.4c-.5-.3-.9-.6-1.2-1-.3-.4-.5-.9-.6-1.5-.1-.6-.2-1.1-.2-1.7V48h-1.7v9.1c0 .8.1 1.6.3 2.3s.5 1.4 1 1.9c.4.5 1 1 1.7 1.3.7.3 1.6.5 2.6.5s1.9-.2 2.6-.5c.7-.3 1.3-.8 1.7-1.3.4-.5.8-1.2 1-1.9s.3-1.5.3-2.3V48h-1.7v8.9zM246.2 56.1h3.4v4.5c-.5.3-1.1.5-1.8.6-.7.1-1.3.2-1.9.2-.9 0-1.7-.2-2.5-.5s-1.4-.7-1.9-1.3-.9-1.2-1.2-1.9c-.3-.7-.4-1.6-.4-2.4 0-.9.1-1.7.4-2.5.3-.7.7-1.4 1.2-1.9s1.2-1 1.9-1.3 1.5-.5 2.4-.5c.7 0 1.5.1 2.2.4.7.3 1.3.7 1.8 1.2l1.3-1.4c-.7-.7-1.5-1.2-2.4-1.5s-1.8-.4-2.8-.4c-1.1 0-2.1.2-3.1.6-1 .4-1.8.9-2.5 1.6-.7.7-1.3 1.5-1.7 2.4-.4.9-.6 2-.6 3.2 0 1.2.2 2.2.6 3.2.4.9.9 1.8 1.6 2.4s1.5 1.2 2.5 1.6c1 .4 2 .6 3.2.6 1 0 1.9-.1 2.8-.3.9-.2 1.8-.6 2.7-1v-7.2h-5.1v1.6zM267.3 49.8c-.7-.7-1.5-1.2-2.4-1.6-.9-.4-2-.6-3.1-.6s-2.2.2-3.1.6c-.9.4-1.7.9-2.4 1.6-.7.7-1.2 1.5-1.6 2.5-.4.9-.6 2-.6 3.1s.2 2.1.6 3.1c.4.9.9 1.8 1.6 2.5.7.7 1.5 1.2 2.4 1.6s2 .6 3.1.6 2.2-.2 3.1-.6 1.7-.9 2.4-1.6c.7-.7 1.2-1.5 1.6-2.5.4-1 .6-2 .6-3.1s-.2-2.1-.6-3.1c-.3-1-.9-1.8-1.6-2.5zm-.1 8c-.3.7-.7 1.4-1.2 1.9s-1.1 1-1.8 1.3c-.7.3-1.5.5-2.4.5-.9 0-1.6-.2-2.4-.5-.7-.3-1.3-.8-1.8-1.3-.5-.6-.9-1.2-1.2-1.9-.3-.7-.4-1.5-.4-2.4s.1-1.6.4-2.4c.3-.7.7-1.4 1.2-1.9.5-.6 1.1-1 1.8-1.3.7-.3 1.5-.5 2.4-.5.9 0 1.6.2 2.4.5.7.3 1.3.8 1.8 1.3s.9 1.2 1.2 1.9c.3.7.4 1.5.4 2.4s-.1 1.6-.4 2.4z"/></svg> \ No newline at end of file
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 395.8 102"><style>.st0{fill:#181919}</style><path class="st0" d="M98.7 34.3L80 53V41.7l24.3-24.3-5.6-5.7L80 30.4V.6h-8v29.8L53.3 11.7l-5.6 5.7L72 41.7V53L53.3 34.4 31.9 12.9V.6h-8v12.3L-.4 37.2l5.6 5.7 18.7-18.7v11.4L-.4 59.8l5.6 5.7 18.7-18.6v55.5h8V46.8l18.6 18.7 5.7-5.7-24.3-24.3V24.2l18.6 18.7L72 64.3v38.1h8V64.3L104.3 40zM126.8 53.1h6.9V37.2h16.8V31h-16.8V20.9h17.9v-6.1h-24.8zM190.2 19.1c-1.8-1.8-3.9-3.1-6.4-4-2.5-.9-5.2-1.4-8.2-1.3-3 0-5.7.5-8.1 1.4-2.5 1-4.6 2.3-6.4 4.1-1.8 1.8-3.2 3.9-4.2 6.4-1 2.5-1.5 5.3-1.5 8.4 0 3 .5 5.7 1.5 8.2 1 2.5 2.4 4.6 4.2 6.3 1.8 1.7 3.9 3.1 6.4 4.1 2.5 1 5.2 1.4 8.1 1.4 3 0 5.7-.6 8.2-1.5 2.5-1 4.6-2.4 6.4-4.1 1.8-1.8 3.2-3.9 4.2-6.3 1-2.5 1.5-5.2 1.5-8.2 0-3.1-.5-5.8-1.5-8.3-1-2.7-2.4-4.8-4.2-6.6zm-2.3 20.2c-.6 1.7-1.5 3.2-2.7 4.5-1.2 1.3-2.5 2.3-4.2 3-1.6.7-3.4 1.1-5.4 1.1-2 0-3.8-.4-5.4-1.1-1.6-.7-3-1.7-4.1-3-1.2-1.3-2-2.8-2.7-4.5-.6-1.7-.9-3.6-.9-5.7 0-1.9.3-3.7.9-5.4.6-1.7 1.5-3.1 2.7-4.4 1.2-1.2 2.5-2.2 4.1-2.9 1.6-.7 3.4-1.1 5.4-1.1 2 0 3.8.3 5.4 1.1 1.6.7 3 1.7 4.2 2.9 1.2 1.2 2 2.7 2.7 4.4.6 1.7 1 3.4 1 5.4-.1 2.1-.4 4-1 5.7zM226.5 32.7c1.5-1.9 2.3-4.2 2.3-7 0-2.2-.4-3.9-1.2-5.4-.8-1.4-1.9-2.5-3.2-3.4-1.3-.8-2.9-1.4-4.6-1.8-1.7-.3-3.5-.5-5.3-.5h-13.3v38.3h6.8V36.8h5l8.9 16.2h8.2l-10.2-16.9c2.9-.4 5.1-1.5 6.6-3.4zm-10.3-1.8c-1 .1-1.9.1-2.9.1H208V20.6h5.9c.9 0 1.8.1 2.7.2.9.1 1.8.3 2.5.7.8.3 1.4.9 1.8 1.5.5.7.7 1.6.7 2.7 0 1.3-.3 2.2-.8 2.9-.5.7-1.2 1.2-2 1.6-.7.4-1.6.6-2.6.7zM241.6 36.5h17.6v-6.2h-17.6v-9.4h18.6v-6.1h-25.4v38.3h26.4v-6.2h-19.6zM286.8 33c-1.3-.8-2.8-1.5-4.4-1.9-1.6-.5-3-1-4.4-1.5-1.3-.5-2.5-1.1-3.4-1.8-.9-.7-1.4-1.7-1.4-3 0-.9.2-1.6.5-2.2.4-.6.8-1.1 1.4-1.5.6-.4 1.3-.7 2-.9.7-.2 1.5-.3 2.3-.3 1.3 0 2.6.2 3.8.7 1.2.5 2.2 1.3 2.9 2.3l5-5.2c-1.5-1.4-3.2-2.4-5.1-3-1.9-.6-3.8-.9-5.9-.9-1.8 0-3.5.2-5.2.7-1.7.5-3.2 1.2-4.5 2.1-1.3 1-2.4 2.2-3.2 3.6-.8 1.4-1.2 3.2-1.2 5.1 0 2.3.5 4.1 1.4 5.4.9 1.4 2 2.4 3.3 3.2 1.3.8 2.8 1.5 4.4 1.9 1.6.5 3 1 4.4 1.5 1.3.5 2.5 1.2 3.4 1.9.9.8 1.4 1.8 1.4 3.2 0 .9-.2 1.6-.6 2.3-.4.7-.9 1.2-1.6 1.7-.7.4-1.4.8-2.2 1-.8.2-1.6.3-2.4.3-1.5 0-2.9-.3-4.3-1.1s-2.4-1.7-3.3-2.9l-5.1 5c1.6 1.9 3.5 3.2 5.7 4 2.2.8 4.5 1.2 6.9 1.2 1.9 0 3.7-.3 5.4-.8 1.7-.5 3.2-1.3 4.5-2.3 1.3-1 2.3-2.3 3.1-3.8.8-1.5 1.1-3.3 1.1-5.4 0-2.3-.5-4.1-1.3-5.5-.9-1.1-2-2.2-3.4-3.1zM294.4 20.9h11.7v32.2h6.8V20.9h11.8v-6.1h-30.3zM356 32.7c1.5-1.9 2.3-4.2 2.3-7 0-2.2-.4-3.9-1.2-5.4-.8-1.4-1.9-2.5-3.2-3.4-1.3-.8-2.9-1.4-4.6-1.8-1.7-.3-3.5-.5-5.3-.5h-13.3v38.3h6.8V36.8h5l8.9 16.2h8.2l-10.2-16.9c2.9-.4 5-1.5 6.6-3.4zm-10.3-1.8c-1 .1-1.9.1-2.9.1h-5.3V20.6h5.9c.9 0 1.8.1 2.7.2.9.1 1.8.3 2.5.7.8.3 1.4.9 1.8 1.5.5.7.7 1.6.7 2.7 0 1.3-.3 2.2-.8 2.9-.5.7-1.2 1.2-2 1.6-.7.4-1.6.6-2.6.7zM387.1 14.8L377.6 30l-9.4-15.2h-8.6L374 36.7v16.4h6.8V36.7l14.4-21.9z"/><g><path class="st0" d="M136 67.6h2.4l9 21.1h-2.9l-2.1-5.2h-10.5l-2.2 5.2h-2.8l9.1-21.1zm1.1 3.2l-4.4 10.4h8.6l-4.2-10.4zM173.1 72c-.6-.9-1.4-1.5-2.4-1.9s-1.9-.6-2.9-.6c-1.2 0-2.2.2-3.2.7s-1.8 1.1-2.5 1.9c-.7.8-1.3 1.7-1.7 2.8s-.6 2.2-.6 3.3c0 1.2.2 2.4.6 3.4.4 1.1.9 2 1.7 2.8.7.8 1.5 1.4 2.5 1.9s2.1.7 3.3.7c1.3 0 2.4-.3 3.5-.8 1-.5 1.9-1.2 2.6-2.2l1.9 1.6c-1 1.3-2.1 2.2-3.4 2.8-1.3.6-2.9.9-4.5.9-1.5 0-2.9-.3-4.2-.8-1.3-.6-2.4-1.3-3.4-2.3-1-1-1.7-2.1-2.3-3.5-.5-1.3-.8-2.8-.8-4.4 0-1.5.3-3 .8-4.3s1.3-2.5 2.2-3.5 2.1-1.8 3.4-2.4c1.3-.6 2.7-.9 4.3-.9 1.4 0 2.8.3 4.1.8 1.3.5 2.4 1.4 3.3 2.5l-2.3 1.5zM179.3 67.6h3.7l7.1 16.5h.1l7.2-16.5h3.6v21.1h-2.5V71h-.1l-7.6 17.7h-1.5L181.9 71h-.1v17.7h-2.5V67.6zM216.3 71.3c-.4-.7-1-1.2-1.7-1.5-.7-.3-1.4-.5-2.2-.5-.6 0-1.1.1-1.6.2s-1 .3-1.4.6c-.4.3-.8.6-1 1.1-.3.5-.4 1-.4 1.6 0 .5.1.9.2 1.3s.4.7.7 1c.3.3.8.6 1.4.8.6.3 1.3.5 2.1.8.8.3 1.6.5 2.4.8.8.3 1.4.7 2 1.1.6.5 1.1 1 1.4 1.7.3.7.5 1.5.5 2.6s-.2 2-.6 2.7c-.4.8-1 1.4-1.7 1.9s-1.5.9-2.4 1.1-1.8.4-2.8.4c-.6 0-1.2-.1-1.8-.2-.6-.1-1.2-.3-1.8-.5-.6-.2-1.1-.5-1.6-.9s-.9-.8-1.3-1.4l2.1-1.8c.5.8 1.1 1.4 1.9 1.8.8.4 1.7.6 2.6.6.5 0 1.1-.1 1.6-.2s1-.4 1.5-.7c.4-.3.8-.7 1.1-1.1.3-.5.4-1 .4-1.6 0-.7-.1-1.2-.3-1.6-.2-.4-.6-.8-1-1.1-.5-.3-1-.6-1.7-.8-.7-.2-1.5-.5-2.4-.8-.8-.2-1.4-.5-2.1-.8-.6-.3-1.2-.7-1.7-1.1-.5-.4-.8-1-1.1-1.6-.3-.6-.4-1.4-.4-2.2 0-1 .2-1.9.6-2.6.4-.8.9-1.4 1.6-1.9.7-.5 1.4-.9 2.3-1.1.9-.3 1.7-.4 2.7-.4 1.2 0 2.3.2 3.3.5 1 .4 1.9 1 2.6 1.9l-2 1.9zM231.1 67.6h13.1v2.3h-10.6v7h9.8v2.3h-9.8v9.5h-2.5V67.6zM257.5 89.2c-1.6 0-3.1-.3-4.4-.8-1.3-.6-2.5-1.3-3.5-2.3-1-1-1.7-2.2-2.3-3.5s-.8-2.8-.8-4.4c0-1.6.3-3.1.8-4.4.5-1.4 1.3-2.5 2.3-3.5 1-1 2.1-1.8 3.5-2.3 1.3-.6 2.8-.8 4.4-.8 1.6 0 3.1.3 4.4.8 1.3.6 2.5 1.3 3.5 2.3 1 1 1.7 2.2 2.3 3.5.5 1.4.8 2.8.8 4.4 0 1.6-.3 3.1-.8 4.4s-1.3 2.5-2.3 3.5c-1 1-2.1 1.8-3.5 2.3-1.4.6-2.8.8-4.4.8zm0-2.3c1.2 0 2.4-.2 3.4-.7 1-.5 1.9-1.1 2.6-1.9.7-.8 1.3-1.7 1.7-2.8.4-1.1.6-2.2.6-3.4 0-1.2-.2-2.3-.6-3.4-.4-1.1-1-2-1.7-2.8-.7-.8-1.6-1.4-2.6-1.9s-2.1-.7-3.4-.7c-1.2 0-2.4.2-3.4.7-1 .5-1.9 1.1-2.6 1.9-.7.8-1.3 1.7-1.7 2.8-.4 1.1-.6 2.2-.6 3.4 0 1.2.2 2.3.6 3.4.4 1.1 1 2 1.7 2.8.7.8 1.6 1.4 2.6 1.9s2.1.7 3.4.7zM272.5 67.6h5.4c1 0 2 .1 3 .2s1.9.4 2.7.8c.8.4 1.4 1 1.9 1.7.5.8.7 1.8.7 3.1 0 1.5-.5 2.8-1.4 3.7s-2.2 1.6-3.9 1.8l6 9.7h-3.1l-5.7-9.5H275v9.5h-2.5v-21zm2.5 9.3h2.2c.7 0 1.4 0 2.2-.1.7 0 1.4-.2 2.1-.4s1.1-.6 1.5-1c.4-.5.6-1.1.6-2 0-.8-.1-1.4-.4-1.8-.3-.5-.7-.8-1.2-1.1s-1-.4-1.6-.5c-.6-.1-1.2-.1-1.8-.1H275v7zM298.9 67.6h2.5v8.9h11.2v-8.9h2.5v21.1h-2.5v-9.8h-11.2v9.8h-2.5V67.6zM336.2 80.7c0 1.2-.1 2.2-.4 3.3-.3 1-.7 1.9-1.4 2.7-.6.8-1.4 1.4-2.5 1.9-1 .5-2.2.7-3.7.7s-2.7-.2-3.7-.7c-1-.5-1.8-1.1-2.5-1.9-.6-.8-1.1-1.7-1.4-2.7-.3-1-.4-2.1-.4-3.3v-13h2.5v12.7c0 .9.1 1.7.3 2.5s.5 1.5.9 2.1c.4.6 1 1.1 1.7 1.5.7.4 1.6.6 2.6.6s1.9-.2 2.6-.6 1.2-.9 1.7-1.5c.4-.6.7-1.3.9-2.1.2-.8.3-1.6.3-2.5V67.6h2.5v13.1zM359.3 87.3c-1.2.7-2.5 1.2-3.8 1.5-1.3.3-2.7.5-4.1.5-1.6 0-3.2-.3-4.5-.8-1.4-.5-2.6-1.3-3.6-2.3-1-1-1.8-2.1-2.3-3.5-.6-1.4-.8-2.9-.8-4.5 0-1.7.3-3.2.9-4.5s1.4-2.5 2.4-3.5 2.2-1.7 3.6-2.2c1.4-.5 2.8-.8 4.4-.8 1.4 0 2.7.2 4 .6s2.4 1.1 3.4 2.1l-1.9 2c-.7-.8-1.6-1.4-2.6-1.8-1-.4-2.1-.6-3.1-.6-1.2 0-2.3.2-3.4.7-1 .4-1.9 1-2.7 1.8-.8.8-1.4 1.7-1.8 2.8s-.6 2.2-.6 3.5c0 1.2.2 2.4.6 3.5s1 2 1.8 2.8c.8.8 1.7 1.4 2.8 1.8s2.3.7 3.5.7c.9 0 1.7-.1 2.7-.3.9-.2 1.8-.5 2.6-.9v-6.5h-4.9v-2.3h7.4v10.2zM374.3 89.2c-1.6 0-3.1-.3-4.4-.8-1.3-.6-2.5-1.3-3.5-2.3-1-1-1.7-2.2-2.3-3.5s-.8-2.8-.8-4.4c0-1.6.3-3.1.8-4.4.5-1.4 1.3-2.5 2.3-3.5 1-1 2.1-1.8 3.5-2.3 1.3-.6 2.8-.8 4.4-.8 1.6 0 3.1.3 4.4.8 1.3.6 2.5 1.3 3.5 2.3 1 1 1.7 2.2 2.3 3.5.5 1.4.8 2.8.8 4.4 0 1.6-.3 3.1-.8 4.4s-1.3 2.5-2.3 3.5c-1 1-2.1 1.8-3.5 2.3-1.3.6-2.8.8-4.4.8zm0-2.3c1.2 0 2.4-.2 3.4-.7 1-.5 1.9-1.1 2.6-1.9.7-.8 1.3-1.7 1.7-2.8.4-1.1.6-2.2.6-3.4 0-1.2-.2-2.3-.6-3.4-.4-1.1-1-2-1.7-2.8-.7-.8-1.6-1.4-2.6-1.9s-2.1-.7-3.4-.7c-1.2 0-2.4.2-3.4.7-1 .5-1.9 1.1-2.6 1.9-.7.8-1.3 1.7-1.7 2.8-.4 1.1-.6 2.2-.6 3.4 0 1.2.2 2.3.6 3.4.4 1.1 1 2 1.7 2.8.7.8 1.6 1.4 2.6 1.9 1.1.5 2.2.7 3.4.7z"/></g></svg> \ No newline at end of file
diff --git a/docs/themes/gohugoioTheme/static/images/sponsors/linode-logo_standard_light_medium.png b/docs/themes/gohugoioTheme/static/images/sponsors/linode-logo_standard_light_medium.png
new file mode 100644
index 000000000..22daa6612
--- /dev/null
+++ b/docs/themes/gohugoioTheme/static/images/sponsors/linode-logo_standard_light_medium.png
Binary files differ