mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
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
This commit is contained in:
parent
efa74c5c6e
commit
6aa5c9117f
22 changed files with 388 additions and 101 deletions
|
@ -4828,7 +4828,7 @@ pre {
|
||||||
right: 50%;*/
|
right: 50%;*/
|
||||||
/*margin-left: -30vw;*/
|
/*margin-left: -30vw;*/
|
||||||
margin-right: -30vw;
|
margin-right: -30vw;
|
||||||
max-width: 100vw;
|
max-width: 48vw;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
.code-block .line-numbers-rows {
|
.code-block .line-numbers-rows {
|
||||||
|
|
|
@ -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`.
|
: an array of paths to videos related to the page; used by the `opengraph` [internal template](/templates/internal) to populate `og:video`.
|
||||||
|
|
||||||
weight
|
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.
|
||||||
|
|
||||||
\<taxonomies\>
|
\<taxonomies\>
|
||||||
: 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._
|
: 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._
|
||||||
|
|
|
@ -1,10 +1,9 @@
|
||||||
---
|
---
|
||||||
title: Taxonomies
|
title: Taxonomies
|
||||||
linktitle:
|
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
|
date: 2017-02-01
|
||||||
publishdate: 2017-02-01
|
publishdate: 2017-02-01
|
||||||
lastmod: 2017-02-01
|
|
||||||
keywords: [taxonomies,metadata,front matter,terms]
|
keywords: [taxonomies,metadata,front matter,terms]
|
||||||
categories: [content management]
|
categories: [content management]
|
||||||
menu:
|
menu:
|
||||||
|
@ -32,7 +31,6 @@ Term
|
||||||
Value
|
Value
|
||||||
: a piece of content assigned to a term
|
: a piece of content assigned to a term
|
||||||
|
|
||||||
{{< youtube pCPCQgqC8RA >}}
|
|
||||||
|
|
||||||
## Example Taxonomy: Movie Website
|
## 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:
|
If you do not want Hugo to create any taxonomies, set `disableKinds` in your [site config][config] to the following:
|
||||||
|
|
||||||
{{< code-toggle copy="false" >}}
|
{{< code-toggle copy="false" >}}
|
||||||
disableKinds = ["taxonomy","taxonomyTerm"]
|
disableKinds = ["taxonomy","term"]
|
||||||
{{</ code-toggle >}}
|
{{</ code-toggle >}}
|
||||||
|
|
||||||
|
{{< 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
|
### 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:
|
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,9 +192,9 @@ 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/).
|
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 %}}
|
{{% /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/<TAXONOMY>/<TERM>/_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/<TAXONOMY>/<TERM>/_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" >}}
|
{{< code file="/content/actors/bruce-willis/_index.md" >}}
|
||||||
---
|
---
|
||||||
|
@ -201,7 +203,6 @@ If you need to add custom metadata to your taxonomy terms, you will need to crea
|
||||||
---
|
---
|
||||||
{{< /code >}}
|
{{< /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/
|
[`urlize` template function]: /functions/urlize/
|
||||||
[content section]: /content-management/sections/
|
[content section]: /content-management/sections/
|
||||||
|
|
34
content/en/functions/hmac.md
Normal file
34
content/en/functions/hmac.md
Normal file
|
@ -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!"}},
|
||||||
|
<!-- returns the string "b6d11b6c53830b9d87036272ca9fe9d19306b8f9d8aa07b15da27d89e6e34f40"
|
||||||
|
```
|
||||||
|
|
||||||
|
Supported hash functions:
|
||||||
|
|
||||||
|
* md5
|
||||||
|
* sha1
|
||||||
|
* sha256
|
||||||
|
* sha512
|
|
@ -87,6 +87,8 @@ Note that this is only supported with the [Goldmark](#goldmark) renderer.
|
||||||
|
|
||||||
Render Hooks allow custom templates to override markdown rendering functionality. You can do this by creating templates with base names `render-{feature}` in `layouts/_default/_markup`.
|
Render Hooks allow custom templates to override markdown rendering functionality. You can do this by creating templates with base names `render-{feature}` in `layouts/_default/_markup`.
|
||||||
|
|
||||||
|
You can also create type/section specific hooks in `layouts/[type/section]/_markup`, e.g.: `layouts/blog/_markup`.{{< new-in "0.71.0" >}}
|
||||||
|
|
||||||
The features currently supported are:
|
The features currently supported are:
|
||||||
|
|
||||||
* `image`
|
* `image`
|
||||||
|
|
|
@ -124,7 +124,7 @@ 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.
|
: 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 ([])
|
disableKinds ([])
|
||||||
: Enable disabling of all pages of the specified *Kinds*. Allowed values in this list: `"page"`, `"home"`, `"section"`, `"taxonomy"`, `"taxonomyTerm"`, `"RSS"`, `"sitemap"`, `"robotsTXT"`, `"404"`.
|
: Enable disabling of all pages of the specified *Kinds*. Allowed values in this list: `"page"`, `"home"`, `"section"`, `"taxonomy"`, `"term"`, `"RSS"`, `"sitemap"`, `"robotsTXT"`, `"404"`.
|
||||||
|
|
||||||
disableLiveReload (false)
|
disableLiveReload (false)
|
||||||
: Disable automatic live reloading of browser window.
|
: Disable automatic live reloading of browser window.
|
||||||
|
@ -514,7 +514,7 @@ Default configuration:
|
||||||
|
|
||||||
Since Hugo 0.52 you can configure more than just the `cacheDir`. This is the default configuration:
|
Since Hugo 0.52 you can configure more than just the `cacheDir`. This is the default configuration:
|
||||||
|
|
||||||
```toml
|
{{< code-toggle >}}
|
||||||
[caches]
|
[caches]
|
||||||
[caches.getjson]
|
[caches.getjson]
|
||||||
dir = ":cacheDir/:project"
|
dir = ":cacheDir/:project"
|
||||||
|
@ -531,7 +531,7 @@ maxAge = -1
|
||||||
[caches.modules]
|
[caches.modules]
|
||||||
dir = ":cacheDir/modules"
|
dir = ":cacheDir/modules"
|
||||||
maxAge = -1
|
maxAge = -1
|
||||||
```
|
{{< /code-toggle >}}
|
||||||
|
|
||||||
You can override any of these cache settings in your own `config.toml`.
|
You can override any of these cache settings in your own `config.toml`.
|
||||||
|
|
||||||
|
|
|
@ -46,7 +46,7 @@ Ideally, you should install it somewhere in your `PATH` for easy use. `/usr/loca
|
||||||
|
|
||||||
### Docker
|
### Docker
|
||||||
|
|
||||||
We currently do not official Hugo images for Docker, but we do recommend these up to date distributions: https://hub.docker.com/r/klakegg/hugo/
|
We currently do not offer official Hugo images for Docker, but we do recommend these up to date distributions: https://hub.docker.com/r/klakegg/hugo/
|
||||||
|
|
||||||
### Homebrew (macOS)
|
### Homebrew (macOS)
|
||||||
|
|
||||||
|
|
|
@ -58,7 +58,7 @@ The above will create a new Hugo site in a folder named `quickstart`.
|
||||||
|
|
||||||
See [themes.gohugo.io](https://themes.gohugo.io/) for a list of themes to consider. This quickstart uses the beautiful [Ananke theme](https://themes.gohugo.io/gohugo-theme-ananke/).
|
See [themes.gohugo.io](https://themes.gohugo.io/) for a list of themes to consider. This quickstart uses the beautiful [Ananke theme](https://themes.gohugo.io/gohugo-theme-ananke/).
|
||||||
|
|
||||||
First, download the theme from GitHub and add it to your site's `theme` directory:
|
First, download the theme from GitHub and add it to your site's `themes` directory:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd quickstart
|
cd quickstart
|
||||||
|
|
|
@ -59,6 +59,7 @@ This is a much simpler setup as your Hugo files and generated content are publis
|
||||||
* Press <kbd>Ctrl</kbd>+<kbd>C</kbd> to kill the server
|
* Press <kbd>Ctrl</kbd>+<kbd>C</kbd> to kill the server
|
||||||
* Before proceeding run `rm -rf public` to completely remove the `public` directory
|
* Before proceeding run `rm -rf public` to completely remove the `public` directory
|
||||||
6. `git submodule add -b master https://github.com/<USERNAME>/<USERNAME>.github.io.git public`. This creates a git [submodule][]. Now when you run the `hugo` command to build your site to `public`, the created `public` directory will have a different remote origin (i.e. hosted GitHub repository).
|
6. `git submodule add -b master https://github.com/<USERNAME>/<USERNAME>.github.io.git public`. This creates a git [submodule][]. Now when you run the `hugo` command to build your site to `public`, the created `public` directory will have a different remote origin (i.e. hosted GitHub repository).
|
||||||
|
7. Make sure the `baseURL` in your config file is updated with: `<USERNAME>.github.io`
|
||||||
|
|
||||||
### Put it Into a Script
|
### Put it Into a Script
|
||||||
|
|
||||||
|
|
BIN
content/en/news/0.73.0-relnotes/hugo-73-featured.png
Normal file
BIN
content/en/news/0.73.0-relnotes/hugo-73-featured.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 182 KiB |
64
content/en/news/0.73.0-relnotes/index.md
Normal file
64
content/en/news/0.73.0-relnotes/index.md
Normal file
|
@ -0,0 +1,64 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
date: 2020-06-23
|
||||||
|
title: "Summer Breeze"
|
||||||
|
description: "Taxonomy terms cleanup, render hooks per section/type, HMAC function, and more."
|
||||||
|
categories: ["Releases"]
|
||||||
|
---
|
||||||
|
|
||||||
|
Again, a release on the small side. Some new features -- one example is that we now support hook templates per section/type, see [#7349](https://github.com/gohugoio/hugo/issues/7349) -- and some important bug fixes.
|
||||||
|
|
||||||
|
But the most important part of this release is that we have now finally cleaned up the terms used for the taxonomy page kinds. This has made the taxonomy feature in Hugo harder to understand than it needed to be. The old/new values for these are `taxonomy` => `term` and `taxonomyTerm` => `taxonomy`. We have taken great care to avoid site breakage. See [#6911](https://github.com/gohugoio/hugo/issues/6911) for more information.
|
||||||
|
|
||||||
|
This release represents **21 contributions by 9 contributors** to the main Hugo code base.bjorn.erik.pedersen leads the Hugo development with a significant amount of contributions, but also a big shoutout to helfper, moorereason, and onedrawingperday for their ongoing contributions.
|
||||||
|
And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the themes site in pristine condition and to [@davidsneighbour](https://github.com/davidsneighbour), [@coliff](https://github.com/coliff) and [@kaushalmodi](https://github.com/kaushalmodi) for all the great work on the documentation site.
|
||||||
|
|
||||||
|
Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
|
||||||
|
which has received **30 contributions by 14 contributors**. A special thanks to christianoliff, bjorn.erik.pedersen, patrick, and hello for their work on the documentation site.
|
||||||
|
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
* Rename taxonomy kinds from taxonomy to term, taxonomyTerm to taxonomy [#6911](https://github.com/gohugoio/hugo/issues/6911)
|
||||||
|
|
||||||
|
## Enhancements
|
||||||
|
|
||||||
|
### Templates
|
||||||
|
|
||||||
|
* tpl/crypto: Add hmac
|
||||||
|
|
||||||
|
### Other
|
||||||
|
|
||||||
|
* Remove some old release notes
|
||||||
|
* Create robots.txt in the domain root directory [#5160](https://github.com/gohugoio/hugo/issues/5160)[#4193](https://github.com/gohugoio/hugo/issues/4193)
|
||||||
|
* Make GroupByParamDate work with string params [#3983](https://github.com/gohugoio/hugo/issues/3983)
|
||||||
|
* Add GroupByLastmod [#7408](https://github.com/gohugoio/hugo/issues/7408)
|
||||||
|
* Rename taxonomy kinds from taxonomy to term, taxonomyTerm to taxonomy [#6911](https://github.com/gohugoio/hugo/issues/6911)[#7395](https://github.com/gohugoio/hugo/issues/7395)
|
||||||
|
* Add genDocsHelper mage target
|
||||||
|
* Regenerate templates
|
||||||
|
* Beautify HTML generated by pagination template [#7199](https://github.com/gohugoio/hugo/issues/7199)
|
||||||
|
* Add a nested data dir test
|
||||||
|
* Use os.PathError in RootMappingFs.doLstat
|
||||||
|
* Remove credit (#7347)
|
||||||
|
* Allow hook template per section/type [#7349](https://github.com/gohugoio/hugo/issues/7349)
|
||||||
|
|
||||||
|
## Fixes
|
||||||
|
|
||||||
|
### Templates
|
||||||
|
|
||||||
|
* Fix bad rounding in NumFmt [#7116](https://github.com/gohugoio/hugo/issues/7116)
|
||||||
|
|
||||||
|
### Other
|
||||||
|
|
||||||
|
* Fix aliases with path in baseURL
|
||||||
|
* Fix server data race/nil pointer in withMaps [#7392](https://github.com/gohugoio/hugo/issues/7392)
|
||||||
|
* Fix order of GetTerms [#7213](https://github.com/gohugoio/hugo/issues/7213)
|
||||||
|
* Fix aliases with uglyURLs
|
||||||
|
* Fix crash for closing shortcode with no .Inner set [#6857](https://github.com/gohugoio/hugo/issues/6857)[#7330](https://github.com/gohugoio/hugo/issues/7330)
|
||||||
|
* Fix aliases with relativeURLs
|
||||||
|
* Fix URL rewrites vs fast render server mode [#7357](https://github.com/gohugoio/hugo/issues/7357)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -424,7 +424,7 @@ In the above example, you may want `{{.Title}}` to point the `title` field you h
|
||||||
### By Publish Date
|
### By Publish Date
|
||||||
|
|
||||||
{{< code file="layouts/partials/by-page-publish-date.html" >}}
|
{{< code file="layouts/partials/by-page-publish-date.html" >}}
|
||||||
<!-- Groups content by month according to the "publishdate" field in front matter -->
|
<!-- Groups content by month according to the "publishDate" field in front matter -->
|
||||||
{{ range .Pages.GroupByPublishDate "2006-01" }}
|
{{ range .Pages.GroupByPublishDate "2006-01" }}
|
||||||
<h3>{{ .Key }}</h3>
|
<h3>{{ .Key }}</h3>
|
||||||
<ul>
|
<ul>
|
||||||
|
@ -438,6 +438,41 @@ In the above example, you may want `{{.Title}}` to point the `title` field you h
|
||||||
{{ end }}
|
{{ end }}
|
||||||
{{< /code >}}
|
{{< /code >}}
|
||||||
|
|
||||||
|
|
||||||
|
### By Lastmod
|
||||||
|
|
||||||
|
{{< code file="layouts/partials/by-page-lastmod.html" >}}
|
||||||
|
<!-- Groups content by month according to the "lastMod" field in front matter -->
|
||||||
|
{{ range .Pages.GroupByLastmod "2006-01" }}
|
||||||
|
<h3>{{ .Key }}</h3>
|
||||||
|
<ul>
|
||||||
|
{{ range .Pages }}
|
||||||
|
<li>
|
||||||
|
<a href="{{ .Permalink }}">{{ .Title }}</a>
|
||||||
|
<div class="meta">{{ .Lastmod.Format "Mon, Jan 2, 2006" }}</div>
|
||||||
|
</li>
|
||||||
|
{{ end }}
|
||||||
|
</ul>
|
||||||
|
{{ end }}
|
||||||
|
{{< /code >}}
|
||||||
|
|
||||||
|
### By Expiry Date
|
||||||
|
|
||||||
|
{{< code file="layouts/partials/by-page-expiry-date.html" >}}
|
||||||
|
<!-- Groups content by month according to the "expiryDate" field in front matter -->
|
||||||
|
{{ range .Pages.GroupByExpiryDate "2006-01" }}
|
||||||
|
<h3>{{ .Key }}</h3>
|
||||||
|
<ul>
|
||||||
|
{{ range .Pages }}
|
||||||
|
<li>
|
||||||
|
<a href="{{ .Permalink }}">{{ .Title }}</a>
|
||||||
|
<div class="meta">{{ .ExpiryDate.Format "Mon, Jan 2, 2006" }}</div>
|
||||||
|
</li>
|
||||||
|
{{ end }}
|
||||||
|
</ul>
|
||||||
|
{{ end }}
|
||||||
|
{{< /code >}}
|
||||||
|
|
||||||
### By Page Parameter
|
### By Page Parameter
|
||||||
|
|
||||||
{{< code file="layouts/partials/by-page-param.html" >}}
|
{{< code file="layouts/partials/by-page-param.html" >}}
|
||||||
|
|
|
@ -41,7 +41,7 @@ Type
|
||||||
: Is value of `type` if set in front matter, else it is the name of the root section (e.g. "blog"). It will always have a value, so if not set, the value is "page".
|
: Is value of `type` if set in front matter, else it is the name of the root section (e.g. "blog"). It will always have a value, so if not set, the value is "page".
|
||||||
|
|
||||||
Section
|
Section
|
||||||
: Is relevant for `section`, `taxonomy` and `taxonomyTerm` types.
|
: Is relevant for `section`, `taxonomy` and `term` types.
|
||||||
|
|
||||||
{{% note %}}
|
{{% note %}}
|
||||||
**Tip:** The examples below looks long and complex. That is the flexibility talking. Most Hugo sites contain just a handful of templates:
|
**Tip:** The examples below looks long and complex. That is the flexibility talking. Most Hugo sites contain just a handful of templates:
|
||||||
|
@ -72,13 +72,13 @@ In Hugo, layouts can live in either the project's or the themes' layout folders,
|
||||||
|
|
||||||
{{< datatable-filtered "output" "layouts" "Kind == section" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
|
{{< datatable-filtered "output" "layouts" "Kind == section" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
|
||||||
|
|
||||||
## Examples: Layout Lookup for Taxonomy List Pages
|
## Examples: Layout Lookup for Taxonomy Pages
|
||||||
|
|
||||||
{{< datatable-filtered "output" "layouts" "Kind == taxonomy" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
|
{{< datatable-filtered "output" "layouts" "Kind == taxonomy" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
|
||||||
|
|
||||||
## Examples: Layout Lookup for Taxonomy Terms Pages
|
## Examples: Layout Lookup for Term Pages
|
||||||
|
|
||||||
{{< datatable-filtered "output" "layouts" "Kind == taxonomyTerm" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
|
{{< datatable-filtered "output" "layouts" "Kind == term" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -137,8 +137,8 @@ Formats are set based on that.
|
||||||
| `page` | HTML |
|
| `page` | HTML |
|
||||||
| `home` | HTML, RSS |
|
| `home` | HTML, RSS |
|
||||||
| `section` | HTML, RSS |
|
| `section` | HTML, RSS |
|
||||||
| `taxonomyTerm` | HTML, RSS |
|
|
||||||
| `taxonomy` | HTML, RSS |
|
| `taxonomy` | HTML, RSS |
|
||||||
|
| `term` | HTML, RSS |
|
||||||
|
|
||||||
### Customizing Output Formats
|
### Customizing Output Formats
|
||||||
|
|
||||||
|
@ -156,10 +156,14 @@ Example from site config file:
|
||||||
|
|
||||||
|
|
||||||
Note that in the above examples, the *output formats* for `section`,
|
Note that in the above examples, the *output formats* for `section`,
|
||||||
`taxonomyTerm` and `taxonomy` will stay at their default value `["HTML",
|
`taxonomy` and `term` will stay at their default value `["HTML",
|
||||||
"RSS"]`.
|
"RSS"]`.
|
||||||
|
|
||||||
* The `outputs` definition is per [`Page` `Kind`][page_kinds] (`page`, `home`, `section`, `taxonomy`, or `taxonomyTerm`).
|
{{< 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 `outputs` section.
|
||||||
|
|
||||||
|
{{% page-kinds %}}
|
||||||
|
|
||||||
|
* The `outputs` definition is per [`Page` `Kind`][page_kinds] (`page`, `home`, `section`, `taxonomy`, or `term`).
|
||||||
* The names (e.g. `HTML`, `AMP`) used must match the `Name` of a defined *Output Format*.
|
* The names (e.g. `HTML`, `AMP`) used must match the `Name` of a defined *Output Format*.
|
||||||
* These names are case insensitive.
|
* These names are case insensitive.
|
||||||
* These can be overridden per `Page` in the front matter of content files.
|
* These can be overridden per `Page` in the front matter of content files.
|
||||||
|
|
|
@ -30,13 +30,7 @@ See [Template Lookup](/templates/lookup-order/).
|
||||||
|
|
||||||
Every `Page` in Hugo has a `.Kind` attribute.
|
Every `Page` in Hugo has a `.Kind` attribute.
|
||||||
|
|
||||||
| Kind | Description | Example |
|
{{% page-kinds %}}
|
||||||
|----------------|--------------------------------------------------------------------|-------------------------------------------------------------------------------|
|
|
||||||
| `home` | The home page | `/index.html` |
|
|
||||||
| `page` | A page showing a _regular page_ | `my-post` page (`/posts/my-post/index.html`) |
|
|
||||||
| `section` | A page listing _regular pages_ from a given [_section_][sections] | `posts` section (`/posts/index.html`) |
|
|
||||||
| `taxonomy` | A page listing _regular pages_ from a given _taxonomy term_ | page for the term `awesome` from `tags` taxonomy (`/tags/awesome/index.html`) |
|
|
||||||
| `taxonomyTerm` | A page listing terms from a given _taxonomy_ | page for the `tags` taxonomy (`/tags/index.html`) |
|
|
||||||
|
|
||||||
## `.Site.GetPage` with Sections
|
## `.Site.GetPage` with Sections
|
||||||
|
|
||||||
|
|
255
data/docs.json
255
data/docs.json
|
@ -480,6 +480,17 @@
|
||||||
"genshitext"
|
"genshitext"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"Name": "Gherkin",
|
||||||
|
"Aliases": [
|
||||||
|
"Cucumber",
|
||||||
|
"FEATURE",
|
||||||
|
"Gherkin",
|
||||||
|
"cucumber",
|
||||||
|
"feature",
|
||||||
|
"gherkin"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"Name": "Gnuplot",
|
"Name": "Gnuplot",
|
||||||
"Aliases": [
|
"Aliases": [
|
||||||
|
@ -528,6 +539,12 @@
|
||||||
"hcl"
|
"hcl"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"Name": "HLB",
|
||||||
|
"Aliases": [
|
||||||
|
"hlb"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"Name": "HTML",
|
"Name": "HTML",
|
||||||
"Aliases": [
|
"Aliases": [
|
||||||
|
@ -998,6 +1015,15 @@
|
||||||
"ragel"
|
"ragel"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"Name": "ReasonML",
|
||||||
|
"Aliases": [
|
||||||
|
"re",
|
||||||
|
"reason",
|
||||||
|
"reasonml",
|
||||||
|
"rei"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"Name": "Rexx",
|
"Name": "Rexx",
|
||||||
"Aliases": [
|
"Aliases": [
|
||||||
|
@ -1027,6 +1053,13 @@
|
||||||
"rust"
|
"rust"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"Name": "SAS",
|
||||||
|
"Aliases": [
|
||||||
|
"SAS",
|
||||||
|
"sas"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"Name": "SCSS",
|
"Name": "SCSS",
|
||||||
"Aliases": [
|
"Aliases": [
|
||||||
|
@ -1250,7 +1283,6 @@
|
||||||
"Name": "TypoScript",
|
"Name": "TypoScript",
|
||||||
"Aliases": [
|
"Aliases": [
|
||||||
"ts",
|
"ts",
|
||||||
"txt",
|
|
||||||
"typoscript"
|
"typoscript"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
@ -1324,6 +1356,12 @@
|
||||||
"yml"
|
"yml"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"Name": "YANG",
|
||||||
|
"Aliases": [
|
||||||
|
"yang"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"Name": "cfstatement",
|
"Name": "cfstatement",
|
||||||
"Aliases": [
|
"Aliases": [
|
||||||
|
@ -1466,6 +1504,7 @@
|
||||||
"keepDefaultAttrVals": true,
|
"keepDefaultAttrVals": true,
|
||||||
"keepDocumentTags": true,
|
"keepDocumentTags": true,
|
||||||
"keepEndTags": true,
|
"keepEndTags": true,
|
||||||
|
"keepQuotes": false,
|
||||||
"keepWhitespace": false
|
"keepWhitespace": false
|
||||||
},
|
},
|
||||||
"css": {
|
"css": {
|
||||||
|
@ -2257,75 +2296,100 @@
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"Example": "Taxonomy list in categories",
|
"Example": "Taxonomy in categories",
|
||||||
"Kind": "taxonomy",
|
"Kind": "taxonomy",
|
||||||
"OutputFormat": "RSS",
|
"OutputFormat": "RSS",
|
||||||
"Suffix": "xml",
|
"Suffix": "xml",
|
||||||
"Template Lookup Order": [
|
"Template Lookup Order": [
|
||||||
"layouts/categories/category.rss.xml",
|
"layouts/categories/category.terms.rss.xml",
|
||||||
|
"layouts/categories/terms.rss.xml",
|
||||||
"layouts/categories/taxonomy.rss.xml",
|
"layouts/categories/taxonomy.rss.xml",
|
||||||
"layouts/categories/rss.xml",
|
"layouts/categories/rss.xml",
|
||||||
"layouts/categories/list.rss.xml",
|
"layouts/categories/list.rss.xml",
|
||||||
"layouts/categories/category.xml",
|
"layouts/categories/category.terms.xml",
|
||||||
|
"layouts/categories/terms.xml",
|
||||||
"layouts/categories/taxonomy.xml",
|
"layouts/categories/taxonomy.xml",
|
||||||
"layouts/categories/list.xml",
|
"layouts/categories/list.xml",
|
||||||
"layouts/taxonomy/category.rss.xml",
|
"layouts/category/category.terms.rss.xml",
|
||||||
"layouts/taxonomy/taxonomy.rss.xml",
|
"layouts/category/terms.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/taxonomy.rss.xml",
|
||||||
"layouts/category/rss.xml",
|
"layouts/category/rss.xml",
|
||||||
"layouts/category/list.rss.xml",
|
"layouts/category/list.rss.xml",
|
||||||
"layouts/category/category.xml",
|
"layouts/category/category.terms.xml",
|
||||||
|
"layouts/category/terms.xml",
|
||||||
"layouts/category/taxonomy.xml",
|
"layouts/category/taxonomy.xml",
|
||||||
"layouts/category/list.xml",
|
"layouts/category/list.xml",
|
||||||
"layouts/_default/category.rss.xml",
|
"layouts/taxonomy/category.terms.rss.xml",
|
||||||
|
"layouts/taxonomy/terms.rss.xml",
|
||||||
|
"layouts/taxonomy/taxonomy.rss.xml",
|
||||||
|
"layouts/taxonomy/rss.xml",
|
||||||
|
"layouts/taxonomy/list.rss.xml",
|
||||||
|
"layouts/taxonomy/category.terms.xml",
|
||||||
|
"layouts/taxonomy/terms.xml",
|
||||||
|
"layouts/taxonomy/taxonomy.xml",
|
||||||
|
"layouts/taxonomy/list.xml",
|
||||||
|
"layouts/_default/category.terms.rss.xml",
|
||||||
|
"layouts/_default/terms.rss.xml",
|
||||||
"layouts/_default/taxonomy.rss.xml",
|
"layouts/_default/taxonomy.rss.xml",
|
||||||
"layouts/_default/rss.xml",
|
"layouts/_default/rss.xml",
|
||||||
"layouts/_default/list.rss.xml",
|
"layouts/_default/list.rss.xml",
|
||||||
"layouts/_default/category.xml",
|
"layouts/_default/category.terms.xml",
|
||||||
|
"layouts/_default/terms.xml",
|
||||||
"layouts/_default/taxonomy.xml",
|
"layouts/_default/taxonomy.xml",
|
||||||
"layouts/_default/list.xml",
|
"layouts/_default/list.xml",
|
||||||
"layouts/_internal/_default/rss.xml"
|
"layouts/_internal/_default/rss.xml"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"Example": "Taxonomy terms in categories",
|
"Example": "Term in categories",
|
||||||
"Kind": "taxonomyTerm",
|
"Kind": "term",
|
||||||
"OutputFormat": "RSS",
|
"OutputFormat": "RSS",
|
||||||
"Suffix": "xml",
|
"Suffix": "xml",
|
||||||
"Template Lookup Order": [
|
"Template Lookup Order": [
|
||||||
"layouts/categories/category.terms.rss.xml",
|
"layouts/categories/term.rss.xml",
|
||||||
"layouts/categories/terms.rss.xml",
|
"layouts/categories/category.rss.xml",
|
||||||
|
"layouts/categories/taxonomy.rss.xml",
|
||||||
"layouts/categories/rss.xml",
|
"layouts/categories/rss.xml",
|
||||||
"layouts/categories/list.rss.xml",
|
"layouts/categories/list.rss.xml",
|
||||||
"layouts/categories/category.terms.xml",
|
"layouts/categories/term.xml",
|
||||||
"layouts/categories/terms.xml",
|
"layouts/categories/category.xml",
|
||||||
|
"layouts/categories/taxonomy.xml",
|
||||||
"layouts/categories/list.xml",
|
"layouts/categories/list.xml",
|
||||||
"layouts/taxonomy/category.terms.rss.xml",
|
"layouts/term/term.rss.xml",
|
||||||
"layouts/taxonomy/terms.rss.xml",
|
"layouts/term/category.rss.xml",
|
||||||
|
"layouts/term/taxonomy.rss.xml",
|
||||||
|
"layouts/term/rss.xml",
|
||||||
|
"layouts/term/list.rss.xml",
|
||||||
|
"layouts/term/term.xml",
|
||||||
|
"layouts/term/category.xml",
|
||||||
|
"layouts/term/taxonomy.xml",
|
||||||
|
"layouts/term/list.xml",
|
||||||
|
"layouts/taxonomy/term.rss.xml",
|
||||||
|
"layouts/taxonomy/category.rss.xml",
|
||||||
|
"layouts/taxonomy/taxonomy.rss.xml",
|
||||||
"layouts/taxonomy/rss.xml",
|
"layouts/taxonomy/rss.xml",
|
||||||
"layouts/taxonomy/list.rss.xml",
|
"layouts/taxonomy/list.rss.xml",
|
||||||
"layouts/taxonomy/category.terms.xml",
|
"layouts/taxonomy/term.xml",
|
||||||
"layouts/taxonomy/terms.xml",
|
"layouts/taxonomy/category.xml",
|
||||||
|
"layouts/taxonomy/taxonomy.xml",
|
||||||
"layouts/taxonomy/list.xml",
|
"layouts/taxonomy/list.xml",
|
||||||
"layouts/category/category.terms.rss.xml",
|
"layouts/category/term.rss.xml",
|
||||||
"layouts/category/terms.rss.xml",
|
"layouts/category/category.rss.xml",
|
||||||
|
"layouts/category/taxonomy.rss.xml",
|
||||||
"layouts/category/rss.xml",
|
"layouts/category/rss.xml",
|
||||||
"layouts/category/list.rss.xml",
|
"layouts/category/list.rss.xml",
|
||||||
"layouts/category/category.terms.xml",
|
"layouts/category/term.xml",
|
||||||
"layouts/category/terms.xml",
|
"layouts/category/category.xml",
|
||||||
|
"layouts/category/taxonomy.xml",
|
||||||
"layouts/category/list.xml",
|
"layouts/category/list.xml",
|
||||||
"layouts/_default/category.terms.rss.xml",
|
"layouts/_default/term.rss.xml",
|
||||||
"layouts/_default/terms.rss.xml",
|
"layouts/_default/category.rss.xml",
|
||||||
|
"layouts/_default/taxonomy.rss.xml",
|
||||||
"layouts/_default/rss.xml",
|
"layouts/_default/rss.xml",
|
||||||
"layouts/_default/list.rss.xml",
|
"layouts/_default/list.rss.xml",
|
||||||
"layouts/_default/category.terms.xml",
|
"layouts/_default/term.xml",
|
||||||
"layouts/_default/terms.xml",
|
"layouts/_default/category.xml",
|
||||||
|
"layouts/_default/taxonomy.xml",
|
||||||
"layouts/_default/list.xml",
|
"layouts/_default/list.xml",
|
||||||
"layouts/_internal/_default/rss.xml"
|
"layouts/_internal/_default/rss.xml"
|
||||||
]
|
]
|
||||||
|
@ -2426,61 +2490,85 @@
|
||||||
"OutputFormat": "HTML",
|
"OutputFormat": "HTML",
|
||||||
"Suffix": "html",
|
"Suffix": "html",
|
||||||
"Template Lookup Order": [
|
"Template Lookup Order": [
|
||||||
"layouts/categories/category.html.html",
|
"layouts/categories/category.terms.html.html",
|
||||||
|
"layouts/categories/terms.html.html",
|
||||||
"layouts/categories/taxonomy.html.html",
|
"layouts/categories/taxonomy.html.html",
|
||||||
"layouts/categories/list.html.html",
|
"layouts/categories/list.html.html",
|
||||||
"layouts/categories/category.html",
|
"layouts/categories/category.terms.html",
|
||||||
|
"layouts/categories/terms.html",
|
||||||
"layouts/categories/taxonomy.html",
|
"layouts/categories/taxonomy.html",
|
||||||
"layouts/categories/list.html",
|
"layouts/categories/list.html",
|
||||||
"layouts/taxonomy/category.html.html",
|
"layouts/category/category.terms.html.html",
|
||||||
"layouts/taxonomy/taxonomy.html.html",
|
"layouts/category/terms.html.html",
|
||||||
"layouts/taxonomy/list.html.html",
|
|
||||||
"layouts/taxonomy/category.html",
|
|
||||||
"layouts/taxonomy/taxonomy.html",
|
|
||||||
"layouts/taxonomy/list.html",
|
|
||||||
"layouts/category/category.html.html",
|
|
||||||
"layouts/category/taxonomy.html.html",
|
"layouts/category/taxonomy.html.html",
|
||||||
"layouts/category/list.html.html",
|
"layouts/category/list.html.html",
|
||||||
"layouts/category/category.html",
|
"layouts/category/category.terms.html",
|
||||||
|
"layouts/category/terms.html",
|
||||||
"layouts/category/taxonomy.html",
|
"layouts/category/taxonomy.html",
|
||||||
"layouts/category/list.html",
|
"layouts/category/list.html",
|
||||||
"layouts/_default/category.html.html",
|
"layouts/taxonomy/category.terms.html.html",
|
||||||
|
"layouts/taxonomy/terms.html.html",
|
||||||
|
"layouts/taxonomy/taxonomy.html.html",
|
||||||
|
"layouts/taxonomy/list.html.html",
|
||||||
|
"layouts/taxonomy/category.terms.html",
|
||||||
|
"layouts/taxonomy/terms.html",
|
||||||
|
"layouts/taxonomy/taxonomy.html",
|
||||||
|
"layouts/taxonomy/list.html",
|
||||||
|
"layouts/_default/category.terms.html.html",
|
||||||
|
"layouts/_default/terms.html.html",
|
||||||
"layouts/_default/taxonomy.html.html",
|
"layouts/_default/taxonomy.html.html",
|
||||||
"layouts/_default/list.html.html",
|
"layouts/_default/list.html.html",
|
||||||
"layouts/_default/category.html",
|
"layouts/_default/category.terms.html",
|
||||||
|
"layouts/_default/terms.html",
|
||||||
"layouts/_default/taxonomy.html",
|
"layouts/_default/taxonomy.html",
|
||||||
"layouts/_default/list.html"
|
"layouts/_default/list.html"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"Example": "Taxonomy term in categories",
|
"Example": "Taxonomy term in categories",
|
||||||
"Kind": "taxonomyTerm",
|
"Kind": "term",
|
||||||
"OutputFormat": "HTML",
|
"OutputFormat": "HTML",
|
||||||
"Suffix": "html",
|
"Suffix": "html",
|
||||||
"Template Lookup Order": [
|
"Template Lookup Order": [
|
||||||
"layouts/categories/category.terms.html.html",
|
"layouts/categories/term.html.html",
|
||||||
"layouts/categories/terms.html.html",
|
"layouts/categories/category.html.html",
|
||||||
|
"layouts/categories/taxonomy.html.html",
|
||||||
"layouts/categories/list.html.html",
|
"layouts/categories/list.html.html",
|
||||||
"layouts/categories/category.terms.html",
|
"layouts/categories/term.html",
|
||||||
"layouts/categories/terms.html",
|
"layouts/categories/category.html",
|
||||||
|
"layouts/categories/taxonomy.html",
|
||||||
"layouts/categories/list.html",
|
"layouts/categories/list.html",
|
||||||
"layouts/taxonomy/category.terms.html.html",
|
"layouts/term/term.html.html",
|
||||||
"layouts/taxonomy/terms.html.html",
|
"layouts/term/category.html.html",
|
||||||
|
"layouts/term/taxonomy.html.html",
|
||||||
|
"layouts/term/list.html.html",
|
||||||
|
"layouts/term/term.html",
|
||||||
|
"layouts/term/category.html",
|
||||||
|
"layouts/term/taxonomy.html",
|
||||||
|
"layouts/term/list.html",
|
||||||
|
"layouts/taxonomy/term.html.html",
|
||||||
|
"layouts/taxonomy/category.html.html",
|
||||||
|
"layouts/taxonomy/taxonomy.html.html",
|
||||||
"layouts/taxonomy/list.html.html",
|
"layouts/taxonomy/list.html.html",
|
||||||
"layouts/taxonomy/category.terms.html",
|
"layouts/taxonomy/term.html",
|
||||||
"layouts/taxonomy/terms.html",
|
"layouts/taxonomy/category.html",
|
||||||
|
"layouts/taxonomy/taxonomy.html",
|
||||||
"layouts/taxonomy/list.html",
|
"layouts/taxonomy/list.html",
|
||||||
"layouts/category/category.terms.html.html",
|
"layouts/category/term.html.html",
|
||||||
"layouts/category/terms.html.html",
|
"layouts/category/category.html.html",
|
||||||
|
"layouts/category/taxonomy.html.html",
|
||||||
"layouts/category/list.html.html",
|
"layouts/category/list.html.html",
|
||||||
"layouts/category/category.terms.html",
|
"layouts/category/term.html",
|
||||||
"layouts/category/terms.html",
|
"layouts/category/category.html",
|
||||||
|
"layouts/category/taxonomy.html",
|
||||||
"layouts/category/list.html",
|
"layouts/category/list.html",
|
||||||
"layouts/_default/category.terms.html.html",
|
"layouts/_default/term.html.html",
|
||||||
"layouts/_default/terms.html.html",
|
"layouts/_default/category.html.html",
|
||||||
|
"layouts/_default/taxonomy.html.html",
|
||||||
"layouts/_default/list.html.html",
|
"layouts/_default/list.html.html",
|
||||||
"layouts/_default/category.terms.html",
|
"layouts/_default/term.html",
|
||||||
"layouts/_default/terms.html",
|
"layouts/_default/category.html",
|
||||||
|
"layouts/_default/taxonomy.html",
|
||||||
"layouts/_default/list.html"
|
"layouts/_default/list.html"
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
@ -3011,6 +3099,23 @@
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"crypto": {
|
"crypto": {
|
||||||
|
"HMAC": {
|
||||||
|
"Description": "HMAC returns a cryptographic hash that uses a key to sign a message.",
|
||||||
|
"Args": [
|
||||||
|
"h",
|
||||||
|
"k",
|
||||||
|
"m"
|
||||||
|
],
|
||||||
|
"Aliases": [
|
||||||
|
"hmac"
|
||||||
|
],
|
||||||
|
"Examples": [
|
||||||
|
[
|
||||||
|
"{{ hmac \"sha256\" \"Secret key\" \"Hello world, gophers!\" }}",
|
||||||
|
"b6d11b6c53830b9d87036272ca9fe9d19306b8f9d8aa07b15da27d89e6e34f40"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
"MD5": {
|
"MD5": {
|
||||||
"Description": "MD5 hashes the given input and returns its MD5 checksum.",
|
"Description": "MD5 hashes the given input and returns its MD5 checksum.",
|
||||||
"Args": [
|
"Args": [
|
||||||
|
@ -3571,6 +3676,22 @@
|
||||||
]
|
]
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
"Pow": {
|
||||||
|
"Description": "Pow returns a raised to the power of b.",
|
||||||
|
"Args": [
|
||||||
|
"a",
|
||||||
|
"b"
|
||||||
|
],
|
||||||
|
"Aliases": [
|
||||||
|
"pow"
|
||||||
|
],
|
||||||
|
"Examples": [
|
||||||
|
[
|
||||||
|
"{{math.Pow 2 3}}",
|
||||||
|
"8"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
"Round": {
|
"Round": {
|
||||||
"Description": "Round returns the nearest integer, rounding half away from zero.",
|
"Description": "Round returns the nearest integer, rounding half away from zero.",
|
||||||
"Args": [
|
"Args": [
|
||||||
|
@ -3802,6 +3923,16 @@
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"resources": {
|
"resources": {
|
||||||
|
"Babel": {
|
||||||
|
"Description": "Babel processes the given Resource with Babel.",
|
||||||
|
"Args": [
|
||||||
|
"args"
|
||||||
|
],
|
||||||
|
"Aliases": [
|
||||||
|
"babel"
|
||||||
|
],
|
||||||
|
"Examples": []
|
||||||
|
},
|
||||||
"Concat": {
|
"Concat": {
|
||||||
"Description": "",
|
"Description": "",
|
||||||
"Args": null,
|
"Args": null,
|
||||||
|
|
14
layouts/shortcodes/content-tree.html
Normal file
14
layouts/shortcodes/content-tree.html
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
<div class="code">
|
||||||
|
<pre><code>
|
||||||
|
├── blog
|
||||||
|
│ ├── _index.md [section]
|
||||||
|
│ ├── first-post.md [page]
|
||||||
|
│ └── second-post
|
||||||
|
│ ├── index.md [page bundle]
|
||||||
|
│ └── photo.jpg [page resource]
|
||||||
|
└── tags
|
||||||
|
├── _index.md [taxonomy]
|
||||||
|
└── funny
|
||||||
|
└── _index.md [term]
|
||||||
|
</code></pre>
|
||||||
|
</div>
|
|
@ -1,5 +1,5 @@
|
||||||
{{ $text := `
|
{{ $text := `
|
||||||
Most of the commands for **Hugo Modules** requires a newer version of Go installed (see https://golang.org/dl/) and the relevant VCS client (e.g. Git, see https://git-scm.com/downloads). If you have an "older" site running on Netlify, you may have to set GO_VERSION to 1.12 in your Environment settings.
|
Most of the commands for **Hugo Modules** requires a newer version of Go installed (see https://golang.org/dl/) and the relevant VCS client (e.g. Git, see https://git-scm.com/downloads/ ). If you have an "older" site running on Netlify, you may have to set GO_VERSION to 1.12 in your Environment settings.
|
||||||
|
|
||||||
For more information about Go Modules, see:
|
For more information about Go Modules, see:
|
||||||
|
|
||||||
|
|
7
layouts/shortcodes/page-kinds.html
Normal file
7
layouts/shortcodes/page-kinds.html
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
| Kind | Description | Example |
|
||||||
|
|----------------|--------------------------------------------------------------------|-------------------------------------------------------------------------------|
|
||||||
|
| `home` | The landing page for the home page | `/index.html` |
|
||||||
|
| `page` | The landing page for a given page | `my-post` page (`/posts/my-post/index.html`) |
|
||||||
|
| `section` | The landing page of a given section | `posts` section (`/posts/index.html`) |
|
||||||
|
| `taxonomy` | The landing page for a taxonomy | `tags` taxonomy (`/tags/index.html`) |
|
||||||
|
| `term` | The landing page for one taxonomy's term | term `awesome` in `tags` taxonomy (`/tags/awesome/index.html`) |
|
|
@ -3,7 +3,7 @@ publish = "public"
|
||||||
command = "hugo --gc --minify"
|
command = "hugo --gc --minify"
|
||||||
|
|
||||||
[context.production.environment]
|
[context.production.environment]
|
||||||
HUGO_VERSION = "0.72.0"
|
HUGO_VERSION = "0.73.0"
|
||||||
HUGO_ENV = "production"
|
HUGO_ENV = "production"
|
||||||
HUGO_ENABLEGITINFO = "true"
|
HUGO_ENABLEGITINFO = "true"
|
||||||
|
|
||||||
|
@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
|
||||||
command = "hugo --gc --minify --enableGitInfo"
|
command = "hugo --gc --minify --enableGitInfo"
|
||||||
|
|
||||||
[context.split1.environment]
|
[context.split1.environment]
|
||||||
HUGO_VERSION = "0.72.0"
|
HUGO_VERSION = "0.73.0"
|
||||||
HUGO_ENV = "production"
|
HUGO_ENV = "production"
|
||||||
|
|
||||||
[context.deploy-preview]
|
[context.deploy-preview]
|
||||||
command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
|
command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
|
||||||
|
|
||||||
[context.deploy-preview.environment]
|
[context.deploy-preview.environment]
|
||||||
HUGO_VERSION = "0.72.0"
|
HUGO_VERSION = "0.73.0"
|
||||||
|
|
||||||
[context.branch-deploy]
|
[context.branch-deploy]
|
||||||
command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
|
command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
|
||||||
|
|
||||||
[context.branch-deploy.environment]
|
[context.branch-deploy.environment]
|
||||||
HUGO_VERSION = "0.72.0"
|
HUGO_VERSION = "0.73.0"
|
||||||
|
|
||||||
[context.next.environment]
|
[context.next.environment]
|
||||||
HUGO_ENABLEGITINFO = "true"
|
HUGO_ENABLEGITINFO = "true"
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 70 KiB |
Binary file not shown.
After Width: | Height: | Size: 117 KiB |
Loading…
Reference in a new issue