From 6aa5c9117fd34644459ea9bcfb1b3f5010658d5d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Tue, 7 Jul 2020 06:58:43 +0200 Subject: [PATCH] Squashed 'docs/' changes from ac2c4a487..cfd74b57d cfd74b57d Add a config file update step. 5957d8815 Wrap cache configuration in code-toggle 914405c0e capitalization and indentation fix for taxonomies page (#1159) 223b80f42 Fix page kinds shortcode not rendering on Taxonomies page (#1158) a9b6fa984 Clarify weight description. 29e121681 Warn about zero weights in front matter. 27ce7ba8c Release 0.73.0 e9596b2ee Merge branch 'temp73' 074a270cd releaser: Add release notes to /docs for release of 0.73.0 4f56a9fc0 width fix of expanding code box in documentation (#1156) f27254d60 css fix of expanding code box in documentation (#1155) 43b576178 Fix incorrect directory name in quick-start (#1154) 16726eacf Add GroupByLastmod 73c31758e Fix for broken link again (#1151) d07067295 Fix broken link (#1144) bc0b484d1 Rename taxonomy kinds from taxonomy to term, taxonomyTerm to taxonomy 674d71842 Fix Typo on Docker section of installation page b87778165 Merge commit 'efa74c5c6e6ff1daddeb5834ea7c69bed2acf171' c7cdebed3 tpl/crypto: Add hmac 260130cc0 Allow hook template per section/type 1f70519d8 releaser: Add release notes to /docs for release of 0.72.0 8516d540c Merge commit '9e1dcefc5f559944b70d2fa520f6acd5c56a69f2' c49195c69 common/maps: Add Scratch.Values 78072df81 Add redirect support to the server 90ca0af6b Fix typo in install instructions git-subtree-dir: docs git-subtree-split: cfd74b57d968d98f88d3ddaee651d9cbe79b7ce1 --- .../gohugoioTheme/assets/output/css/app.css | 2 +- content/en/content-management/front-matter.md | 2 +- content/en/content-management/taxonomies.md | 23 +- content/en/functions/hmac.md | 34 +++ .../getting-started/configuration-markup.md | 2 + content/en/getting-started/configuration.md | 6 +- content/en/getting-started/installing.md | 2 +- content/en/getting-started/quick-start.md | 2 +- .../hosting-on-github.md | 1 + .../news/0.73.0-relnotes/hugo-73-featured.png | Bin 0 -> 186170 bytes content/en/news/0.73.0-relnotes/index.md | 64 +++++ content/en/templates/lists.md | 37 ++- content/en/templates/lookup-order.md | 8 +- content/en/templates/output-formats.md | 12 +- content/en/templates/section-templates.md | 8 +- data/docs.json | 255 +++++++++++++----- layouts/shortcodes/content-tree.html | 14 + layouts/shortcodes/gomodules-info.html | 2 +- layouts/shortcodes/page-kinds.html | 7 + netlify.toml | 8 +- ...034d1_186170_480x0_resize_catmullrom_2.png | Bin 0 -> 72157 bytes ...034d1_186170_640x0_resize_catmullrom_2.png | Bin 0 -> 119653 bytes 22 files changed, 388 insertions(+), 101 deletions(-) create mode 100644 content/en/functions/hmac.md create mode 100644 content/en/news/0.73.0-relnotes/hugo-73-featured.png create mode 100644 content/en/news/0.73.0-relnotes/index.md create mode 100644 layouts/shortcodes/content-tree.html create mode 100644 layouts/shortcodes/page-kinds.html create mode 100644 resources/_gen/images/news/0.73.0-relnotes/hugo-73-featured_hu7b5b76bcc722e972da8ed35f022034d1_186170_480x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.73.0-relnotes/hugo-73-featured_hu7b5b76bcc722e972da8ed35f022034d1_186170_640x0_resize_catmullrom_2.png diff --git a/_vendor/github.com/gohugoio/gohugoioTheme/assets/output/css/app.css b/_vendor/github.com/gohugoio/gohugoioTheme/assets/output/css/app.css index c08fbc9dc..baf3278b0 100644 --- a/_vendor/github.com/gohugoio/gohugoioTheme/assets/output/css/app.css +++ b/_vendor/github.com/gohugoio/gohugoioTheme/assets/output/css/app.css @@ -4828,7 +4828,7 @@ pre { right: 50%;*/ /*margin-left: -30vw;*/ margin-right: -30vw; - max-width: 100vw; + max-width: 48vw; } } .code-block .line-numbers-rows { diff --git a/content/en/content-management/front-matter.md b/content/en/content-management/front-matter.md index b6276a439..a14cb3065 100644 --- a/content/en/content-management/front-matter.md +++ b/content/en/content-management/front-matter.md @@ -135,7 +135,7 @@ videos : an array of paths to videos related to the page; used by the `opengraph` [internal template](/templates/internal) to populate `og:video`. weight -: used for [ordering your content in lists][ordering]. Lower weight gets higher precedence. So content with lower weight will come first. +: used for [ordering your content in lists][ordering]. Lower weight gets higher precedence. So content with lower weight will come first. If set, weights should be non-zero, as 0 is interpreted as an *unset* weight. \ : field name of the *plural* form of the index. See `tags` and `categories` in the above front matter examples. _Note that the plural form of user-defined taxonomies cannot be the same as any of the predefined front matter variables._ diff --git a/content/en/content-management/taxonomies.md b/content/en/content-management/taxonomies.md index 03747e72b..f5ee00cd3 100644 --- a/content/en/content-management/taxonomies.md +++ b/content/en/content-management/taxonomies.md @@ -1,10 +1,9 @@ --- title: Taxonomies linktitle: -description: Hugo includes support for user-defined taxonomies to help you demonstrate logical relationships between content for the end users of your website. +description: Hugo includes support for user-defined taxonomies.. date: 2017-02-01 publishdate: 2017-02-01 -lastmod: 2017-02-01 keywords: [taxonomies,metadata,front matter,terms] categories: [content management] menu: @@ -32,7 +31,6 @@ Term Value : a piece of content assigned to a term -{{< youtube pCPCQgqC8RA >}} ## Example Taxonomy: Movie Website @@ -97,9 +95,13 @@ Without adding a single line to your [site config][config] file, Hugo will autom If you do not want Hugo to create any taxonomies, set `disableKinds` in your [site config][config] to the following: {{< code-toggle copy="false" >}} -disableKinds = ["taxonomy","taxonomyTerm"] +disableKinds = ["taxonomy","term"] {{}} +{{< new-in "0.73.0" >}} We have fixed the before confusing page kinds used for taxonomies (see the listing below) to be in line with the terms used when we talk about taxonomies. We have been careful to avoid site breakage, and you should get an ERROR in the console if you need to adjust your `disableKinds` section. + +{{% page-kinds %}} + ### Default Destinations When taxonomies are used---and [taxonomy templates][] are provided---Hugo will automatically create both a page listing all the taxonomy's terms and individual pages with lists of content associated with each term. For example, a `categories` taxonomy declared in your configuration and used in your content front matter will create the following pages: @@ -190,18 +192,17 @@ By using taxonomic weight, the same piece of content can appear in different pos Currently taxonomies only support the [default `weight => date` ordering of list content](/templates/lists/#default-weight-date). For more information, see the documentation on [taxonomy templates](/templates/taxonomy-templates/). {{% /note %}} -## Add custom metadata to a Taxonomy Term +## Add custom metadata a Taxonomy or Term -If you need to add custom metadata to your taxonomy terms, you will need to create a page for that term at `/content///_index.md` and add your metadata in it's front matter. Continuing with our 'Actors' example, let's say you want to add a wikipedia page link to each actor. Your terms pages would be something like this: +If you need to add custom metadata to your taxonomy terms, you will need to create a page for that term at `/content///_index.md` and add your metadata in it's front matter. Continuing with our 'Actors' example, let's say you want to add a Wikipedia page link to each actor. Your terms pages would be something like this: {{< code file="/content/actors/bruce-willis/_index.md" >}} - --- - title: "Bruce Willis" - wikipedia: "https://en.wikipedia.org/wiki/Bruce_Willis" - --- +--- +title: "Bruce Willis" +wikipedia: "https://en.wikipedia.org/wiki/Bruce_Willis" +--- {{< /code >}} -You can later use your custom metadata as shown in the [Taxonomy Terms Templates documentation](/templates/taxonomy-templates/#displaying-custom-metadata-in-taxonomy-terms-templates). [`urlize` template function]: /functions/urlize/ [content section]: /content-management/sections/ diff --git a/content/en/functions/hmac.md b/content/en/functions/hmac.md new file mode 100644 index 000000000..02343196b --- /dev/null +++ b/content/en/functions/hmac.md @@ -0,0 +1,34 @@ +--- +title: hmac +linktitle: hmac +description: Compute the cryptographic checksum of a message. +godocref: +date: 2020-05-29 +publishdate: 2020-05-29 +lastmod: 2020-05-29 +categories: [functions] +menu: + docs: + parent: "functions" +keywords: [hmac,checksum] +signature: ["hmac HASH_TYPE KEY MESSAGE"] +workson: [] +hugoversion: +relatedfuncs: [hmac] +deprecated: false +aliases: [hmac] +--- + +`hmac` returns a cryptographic hash that uses a key to sign a message. + +``` +{{ hmac "sha256" "Secret key" "Hello world, gophers!"}}, + + {{ range .Pages.GroupByPublishDate "2006-01" }}

{{ .Key }}