mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-29 02:02:09 -05:00
Merge commit 'a8e9fc699a6ff7d578f97a7c553ce844efad8fdb'
This commit is contained in:
commit
098254f175
17 changed files with 65 additions and 41 deletions
|
@ -1,12 +0,0 @@
|
||||||
---
|
|
||||||
linktitle: ""
|
|
||||||
description: ""
|
|
||||||
publishdate: ""
|
|
||||||
lastmod: ""
|
|
||||||
categories: []
|
|
||||||
tags: []
|
|
||||||
weight: 00
|
|
||||||
slug: ""
|
|
||||||
aliases: []
|
|
||||||
toc: false
|
|
||||||
---
|
|
6
docs/archetypes/news/index.md
Normal file
6
docs/archetypes/news/index.md
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
---
|
||||||
|
title: "{{ replace .Name "-" " " | title }}"
|
||||||
|
description: ""
|
||||||
|
date: {{ .Date }}
|
||||||
|
---
|
||||||
|
|
|
@ -2,6 +2,7 @@ baseURL = "https://gohugo.io/"
|
||||||
paginate = 100
|
paginate = 100
|
||||||
defaultContentLanguage = "en"
|
defaultContentLanguage = "en"
|
||||||
enableEmoji = true
|
enableEmoji = true
|
||||||
|
timeZone = "Europe/Oslo"
|
||||||
# Set the unicode character used for the "return" link in page footnotes.
|
# Set the unicode character used for the "return" link in page footnotes.
|
||||||
footnotereturnlinkcontents = "↩"
|
footnotereturnlinkcontents = "↩"
|
||||||
languageCode = "en-us"
|
languageCode = "en-us"
|
||||||
|
|
|
@ -6,8 +6,8 @@
|
||||||
osEnv = ['^PATH$']
|
osEnv = ['^PATH$']
|
||||||
|
|
||||||
[funcs]
|
[funcs]
|
||||||
getenv = ['^HUGO_', '^REPOSITORY_URL$']
|
getenv = ['^HUGO_', '^REPOSITORY_URL$', '^BRANCH$']
|
||||||
|
|
||||||
[http]
|
[http]
|
||||||
methods = ['(?i)GET|POST']
|
methods = ['(?i)GET|POST']
|
||||||
urls = ['.*']
|
urls = ['.*']
|
||||||
|
|
|
@ -35,7 +35,7 @@ But when developing and building your site, the runtime is the `hugo` executable
|
||||||
|
|
||||||
Hugo has a built-in security policy that restricts access to [os/exec](https://pkg.go.dev/os/exec), remote communication and similar.
|
Hugo has a built-in security policy that restricts access to [os/exec](https://pkg.go.dev/os/exec), remote communication and similar.
|
||||||
|
|
||||||
The defdault configuration is listed below. And build using features not whitelisted in the security policy will faill with a detailed message about what needs to be done. Most of these settings are whitelists (string or slice, [Regular Expressions](https://pkg.go.dev/regexp) or `none` which matches nothing).
|
The default configuration is listed below. And build using features not whitelisted in the security policy will faill with a detailed message about what needs to be done. Most of these settings are whitelists (string or slice, [Regular Expressions](https://pkg.go.dev/regexp) or `none` which matches nothing).
|
||||||
|
|
||||||
{{< code-toggle config="security" />}}
|
{{< code-toggle config="security" />}}
|
||||||
|
|
||||||
|
|
|
@ -305,7 +305,7 @@ bgColor = "#ffffff"
|
||||||
# disk space reasons more than anything.
|
# disk space reasons more than anything.
|
||||||
# If you want it all, put ".*" in this config setting.
|
# If you want it all, put ".*" in this config setting.
|
||||||
# Note that if neither this or ExcludeFields is set, Hugo will return a small
|
# Note that if neither this or ExcludeFields is set, Hugo will return a small
|
||||||
# default set.
|
# default set: GPS|Exif|Exposure[M|P|B]|Contrast|Resolution|Sharp|JPEG|Metering|Sensing|Saturation|ColorSpace|Flash|WhiteBalance
|
||||||
includeFields = ""
|
includeFields = ""
|
||||||
|
|
||||||
# Regexp matching the Exif fields you want to exclude. This may be easier to use
|
# Regexp matching the Exif fields you want to exclude. This may be easier to use
|
||||||
|
|
|
@ -128,7 +128,7 @@ images.GaussianBlur SIGMA
|
||||||
|
|
||||||
GaussianBlur creates a filter that applies a gaussian blur to an image.
|
GaussianBlur creates a filter that applies a gaussian blur to an image.
|
||||||
|
|
||||||
### Grayscale
|
## Grayscale
|
||||||
|
|
||||||
{{% funcsig %}}
|
{{% funcsig %}}
|
||||||
images.Grayscale
|
images.Grayscale
|
||||||
|
|
|
@ -18,25 +18,32 @@ toc: true
|
||||||
aliases: [/assets/]
|
aliases: [/assets/]
|
||||||
---
|
---
|
||||||
|
|
||||||
## Get Resource with resources.Get
|
## Get Resource with resources.Get and resources.GetRemote
|
||||||
|
|
||||||
In order to process an asset with Hugo Pipes, it must be retrieved as a `Resource` using `resources.Get`. The first argument can be either a local the path to file relative to the `asset` directory/directories or a remote URL.
|
In order to process an asset with Hugo Pipes, it must be retrieved as a `Resource` using `resources.Get` or `resources.GetRemote`.
|
||||||
|
|
||||||
|
With `resources.Get`, the first argument is a local path relative to the `assets` directory/directories:
|
||||||
|
|
||||||
```go-html-template
|
```go-html-template
|
||||||
{{ $local := resources.Get "sass/main.scss" }}
|
{{ $local := resources.Get "sass/main.scss" }}
|
||||||
{{ $remote := resources.Get "https://www.example.com/styles.scss" }}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
`resources.Get` will always return `nil` if the resource could not be found.
|
With `resources.GetRemote`, the first argument is a remote URL:
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
{{ $remote := resources.GetRemote "https://www.example.com/styles.scss" }}
|
||||||
|
```
|
||||||
|
|
||||||
|
`resources.Get` and `resources.GetRemote` return `nil` if the resource is not found.
|
||||||
|
|
||||||
### Error Handling
|
### Error Handling
|
||||||
|
|
||||||
{{< new-in "0.90.1" >}}
|
{{< new-in "0.91.0" >}}
|
||||||
|
|
||||||
The return value from `resources.Get` includes an `.Err` method that will return an error if the call failed. If you want to just log any error as a `WARNING` you can use a construct similar to the one below.
|
The return value from `resources.GetRemote` includes an `.Err` method that will return an error if the call failed. If you want to just log any error as a `WARNING` you can use a construct similar to the one below.
|
||||||
|
|
||||||
```go-html-template
|
```go-html-template
|
||||||
{{ with resources.Get "https://gohugo.io/images/gohugoio-card-1.png" }}
|
{{ with resources.GetRemote "https://gohugo.io/images/gohugoio-card-1.png" }}
|
||||||
{{ with .Err }}
|
{{ with .Err }}
|
||||||
{{ warnf "%s" . }}
|
{{ warnf "%s" . }}
|
||||||
{{ else }}
|
{{ else }}
|
||||||
|
@ -49,22 +56,22 @@ Note that if you do not handle `.Err` yourself, Hugo will fail the build the fir
|
||||||
|
|
||||||
### Remote Options
|
### Remote Options
|
||||||
|
|
||||||
When fetching a remote `Resource`, `resources.Get` takes an optional options map as the last argument, e.g.:
|
When fetching a remote `Resource`, `resources.GetRemote` takes an optional options map as the last argument, e.g.:
|
||||||
|
|
||||||
```go-html-template
|
```go-html-template
|
||||||
{{ $resource := resources.Get "https://example.org/api" (dict "headers" (dict "Authorization" "Bearer abcd")) }}
|
{{ $resource := resources.GetRemote "https://example.org/api" (dict "headers" (dict "Authorization" "Bearer abcd")) }}
|
||||||
```
|
```
|
||||||
|
|
||||||
If you need multiple values for the same header key, use a slice:
|
If you need multiple values for the same header key, use a slice:
|
||||||
|
|
||||||
```go-html-template
|
```go-html-template
|
||||||
{{ $resource := resources.Get "https://example.org/api" (dict "headers" (dict "X-List" (slice "a" "b" "c"))) }}
|
{{ $resource := resources.GetRemote "https://example.org/api" (dict "headers" (dict "X-List" (slice "a" "b" "c"))) }}
|
||||||
```
|
```
|
||||||
|
|
||||||
You can also change the request method and set the request body:
|
You can also change the request method and set the request body:
|
||||||
|
|
||||||
```go-html-template
|
```go-html-template
|
||||||
{{ $postResponse := resources.Get "https://example.org/api" (dict
|
{{ $postResponse := resources.GetRemote "https://example.org/api" (dict
|
||||||
"method" "post"
|
"method" "post"
|
||||||
"body" `{"complete": true}`
|
"body" `{"complete": true}`
|
||||||
"headers" (dict
|
"headers" (dict
|
||||||
|
@ -75,16 +82,15 @@ You can also change the request method and set the request body:
|
||||||
|
|
||||||
### Caching of Remote Resources
|
### Caching of Remote Resources
|
||||||
|
|
||||||
Remote resources fetched with `resources.Get` will be cached on disk. See [Configure File Caches](/getting-started/configuration/#configure-file-caches) for details.
|
Remote resources fetched with `resources.GetRemote` will be cached on disk. See [Configure File Caches](/getting-started/configuration/#configure-file-caches) for details.
|
||||||
|
|
||||||
## Asset directory
|
## Asset directory
|
||||||
|
|
||||||
Asset files must be stored in the asset directory. This is `/assets` by default, but can be configured via the configuration file's `assetDir` key.
|
Asset files must be stored in the asset directory. This is `/assets` by default, but can be configured via the configuration file's `assetDir` key.
|
||||||
|
|
||||||
|
|
||||||
### Asset Publishing
|
### Asset Publishing
|
||||||
|
|
||||||
Assets will only be published (to `/public`) if `.Permalink` or `.RelPermalink` is used. You can use `.Content` to inline the asset.
|
Hugo publishes assets to the to the `publishDir` (typically `public`) when you invoke `.Permalink`, `.RelPermalink`, or `.Publish`. You can use `.Content` to inline the asset.
|
||||||
|
|
||||||
## Go Pipes
|
## Go Pipes
|
||||||
|
|
||||||
|
|
10
docs/content/en/news/2021-12-17-no-more-releasenotes.md
Normal file
10
docs/content/en/news/2021-12-17-no-more-releasenotes.md
Normal file
|
@ -0,0 +1,10 @@
|
||||||
|
---
|
||||||
|
title: "Release Notes now on GitHub Only"
|
||||||
|
date: 2021-12-17T12:22:47+01:00
|
||||||
|
slug: "no-more-releasenotes-here"
|
||||||
|
description: "Hugo Release Notes now gets released on GitHub Only"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
For details about release notes, you need to go here: https://github.com/gohugoio/hugo/releases -- see this for an Atom feed: https://github.com/gohugoio/hugo/releases.atom
|
||||||
|
|
BIN
docs/content/en/news/2021/0.91.2-relnotes/featured.png
Normal file
BIN
docs/content/en/news/2021/0.91.2-relnotes/featured.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 128 KiB |
9
docs/content/en/news/2021/0.91.2-relnotes/index.md
Normal file
9
docs/content/en/news/2021/0.91.2-relnotes/index.md
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
---
|
||||||
|
title: "Fixes the “Stuck on Build” Bug"
|
||||||
|
description: "Hugo 0.91.2 is the last release before Christmas!"
|
||||||
|
date: 2021-12-23T17:47:41+01:00
|
||||||
|
---
|
||||||
|
|
||||||
|
Read the full change log on [GitHub](https://github.com/gohugoio/hugo/releases/tag/v0.91.2).
|
||||||
|
|
||||||
|
**Merry Christmas to all of you!**
|
|
@ -53,8 +53,8 @@ The example below is a bit contrived, but it illustrates the flexibility of data
|
||||||
|
|
||||||
{{< code-toggle file="jacopastorius" >}}
|
{{< code-toggle file="jacopastorius" >}}
|
||||||
discography = [
|
discography = [
|
||||||
"1974 – Modern American Music … Period! The Criteria Sessions",
|
"1974 - Modern American Music … Period! The Criteria Sessions",
|
||||||
"1974 – Jaco",
|
"1974 - Jaco",
|
||||||
"1976 - Jaco Pastorius",
|
"1976 - Jaco Pastorius",
|
||||||
"1981 - Word of Mouth",
|
"1981 - Word of Mouth",
|
||||||
"1981 - The Birthday Concert (released in 1995)",
|
"1981 - The Birthday Concert (released in 1995)",
|
||||||
|
|
|
@ -40,7 +40,7 @@ The `.File` object contains the following fields:
|
||||||
: the filename without extension (e.g., `foo.en`)
|
: the filename without extension (e.g., `foo.en`)
|
||||||
|
|
||||||
.File.Ext
|
.File.Ext
|
||||||
: the file extension of the content file (e.g., `md`); this can also be called using `.File.Extension` as well. Note that it is *only* the extension without `.`.
|
: the file extension of the content file (e.g., `md`).
|
||||||
|
|
||||||
.File.Lang
|
.File.Lang
|
||||||
: the language associated with the given file if Hugo's [Multilingual features][multilingual] are enabled (e.g., `en`)
|
: the language associated with the given file if Hugo's [Multilingual features][multilingual] are enabled (e.g., `en`)
|
||||||
|
|
|
@ -37,10 +37,10 @@ The `GitInfo` object contains the following fields:
|
||||||
: the abbreviated commit hash (e.g., `866cbcc`)
|
: the abbreviated commit hash (e.g., `866cbcc`)
|
||||||
|
|
||||||
.AuthorName
|
.AuthorName
|
||||||
: the author's name, respecting `.mailmap`
|
: the author's name, respecting [`.mailmap`](https://git-scm.com/docs/gitmailmap)
|
||||||
|
|
||||||
.AuthorEmail
|
.AuthorEmail
|
||||||
: the author's email address, respecting `.mailmap`
|
: the author's email address, respecting [`.mailmap`](https://git-scm.com/docs/gitmailmap)
|
||||||
|
|
||||||
.AuthorDate
|
.AuthorDate
|
||||||
: the author date
|
: the author date
|
||||||
|
|
|
@ -33,6 +33,9 @@ See [`.Scratch`](/functions/scratch/) for page-scoped, writable variables.
|
||||||
.Aliases
|
.Aliases
|
||||||
: aliases of this page
|
: aliases of this page
|
||||||
|
|
||||||
|
.BundleType
|
||||||
|
: the [bundle] type: `leaf`, `branch`, or an empty string if the page is not a bundle.
|
||||||
|
|
||||||
.Content
|
.Content
|
||||||
: the content itself, defined below the front matter.
|
: the content itself, defined below the front matter.
|
||||||
|
|
||||||
|
@ -305,3 +308,4 @@ The top-level key will be preferred. Therefore, the following method, when appli
|
||||||
|
|
||||||
[gitinfo]: /variables/git/
|
[gitinfo]: /variables/git/
|
||||||
[File Variables]: /variables/files/
|
[File Variables]: /variables/files/
|
||||||
|
[bundle]: {{< relref "content-management/page-bundles" >}}
|
||||||
|
|
|
@ -14,7 +14,7 @@
|
||||||
<a href="{{ .Permalink }}">{{ .Title }}</a>
|
<a href="{{ .Permalink }}">{{ .Title }}</a>
|
||||||
</td>
|
</td>
|
||||||
<td class="pv2 ph3">
|
<td class="pv2 ph3">
|
||||||
<a href="{{.Site.Params.ghrepo}}blob/master/content/{{.Lang }}/{{.Path}}">
|
<a href="{{.Site.Params.ghrepo}}blob/master/content/{{.Lang }}/{{.File.Path}}">
|
||||||
{{ with .GitInfo }}{{ .Subject }}{{ else }}Source{{ end }}
|
{{ with .GitInfo }}{{ .Subject }}{{ else }}Source{{ end }}
|
||||||
</a>
|
</a>
|
||||||
</td>
|
</td>
|
||||||
|
|
|
@ -3,7 +3,7 @@ publish = "public"
|
||||||
command = "hugo --gc --minify"
|
command = "hugo --gc --minify"
|
||||||
|
|
||||||
[context.production.environment]
|
[context.production.environment]
|
||||||
HUGO_VERSION = "0.90.1"
|
HUGO_VERSION = "0.91.2"
|
||||||
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.90.1"
|
HUGO_VERSION = "0.91.2"
|
||||||
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.90.1"
|
HUGO_VERSION = "0.91.2"
|
||||||
|
|
||||||
[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.90.1"
|
HUGO_VERSION = "0.91.2"
|
||||||
|
|
||||||
[context.next.environment]
|
[context.next.environment]
|
||||||
HUGO_ENABLEGITINFO = "true"
|
HUGO_ENABLEGITINFO = "true"
|
||||||
|
|
Loading…
Reference in a new issue