diff --git a/assets/images/examples/mask.png b/assets/images/examples/mask.png
new file mode 100644
index 000000000..c3005a669
Binary files /dev/null and b/assets/images/examples/mask.png differ
diff --git a/content/en/about/privacy.md b/content/en/about/privacy.md
index a3491f864..425af0bcf 100644
--- a/content/en/about/privacy.md
+++ b/content/en/about/privacy.md
@@ -39,11 +39,11 @@ respectDoNotTrack = false
[privacy.instagram]
disable = false
simple = false
-[privacy.twitter]
+[privacy.vimeo]
disable = false
enableDNT = false
simple = false
-[privacy.vimeo]
+[privacy.x]
disable = false
enableDNT = false
simple = false
@@ -64,10 +64,10 @@ disable = true
disable = true
[privacy.instagram]
disable = true
-[privacy.twitter]
-disable = true
[privacy.vimeo]
disable = true
+[privacy.x]
+disable = true
[privacy.youtube]
disable = true
{{< /code-toggle >}}
@@ -92,19 +92,19 @@ simple
disableInlineCSS = true
{{< /code-toggle >}}
-### Twitter
+### X
enableDNT
-: Enabling this for the twitter/tweet shortcode, the tweet and its embedded page on your site are not used for purposes that include personalized suggestions and personalized ads.
+: Enabling this for the x shortcode, the post and its embedded page on your site are not used for purposes that include personalized suggestions and personalized ads.
simple
-: If simple mode is enabled, a static and no-JS version of a tweet will be built.
+: If simple mode is enabled, a static and no-JS version of a post will be built.
-**Note:** If you use the _simple mode_ for Twitter, you may want to disable the inline styles provided by Hugo:
+**Note:** If you use the _simple mode_ for X, you may want to disable the inline styles provided by Hugo:
{{< code-toggle file=hugo >}}
[services]
-[services.twitter]
+[services.x]
disableInlineCSS = true
{{< /code-toggle >}}
diff --git a/content/en/commands/hugo.md b/content/en/commands/hugo.md
index ef0bca9a5..42f882ad7 100644
--- a/content/en/commands/hugo.md
+++ b/content/en/commands/hugo.md
@@ -72,7 +72,6 @@ hugo [flags]
* [hugo completion](/commands/hugo_completion/) - Generate the autocompletion script for the specified shell
* [hugo config](/commands/hugo_config/) - Display site configuration
* [hugo convert](/commands/hugo_convert/) - Convert front matter to another format
-* [hugo deploy](/commands/hugo_deploy/) - Deploy your site to a cloud provider
* [hugo env](/commands/hugo_env/) - Display version and environment info
* [hugo gen](/commands/hugo_gen/) - Generate documentation and syntax highlighting styles
* [hugo import](/commands/hugo_import/) - Import a site from another system
diff --git a/content/en/content-management/content-adapters.md b/content/en/content-management/content-adapters.md
index a88bdba5f..90a2d6ba9 100644
--- a/content/en/content-management/content-adapters.md
+++ b/content/en/content-management/content-adapters.md
@@ -193,14 +193,14 @@ Step 3
{{/* Get remote data. */}}
{{ $data := dict }}
{{ $url := "https://gohugo.io/shared/examples/data/books.json" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "Unable to get remote resource %s: %s" $url . }}
- {{ else }}
+ {{ else with .Value }}
{{ $data = . | transform.Unmarshal }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %s" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %s" $url }}
{{ end }}
{{/* Add pages and page resources. */}}
@@ -223,10 +223,10 @@ Step 3
{{/* Add page resource. */}}
{{ $item := . }}
{{ with $url := $item.cover }}
- {{ with resources.GetRemote $url }}
+ {{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "Unable to get remote resource %s: %s" $url . }}
- {{ else }}
+ {{ else with .Value }}
{{ $content := dict "mediaType" .MediaType.Type "value" .Content }}
{{ $params := dict "alt" $item.title }}
{{ $resource := dict
@@ -235,9 +235,9 @@ Step 3
"path" (printf "%s/cover.%s" $item.title .MediaType.SubType)
}}
{{ $.AddResource $resource }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %s" $url }}
{{ end }}
- {{ else }}
- {{ errorf "Unable to get remote resource %s" $url }}
{{ end }}
{{ end }}
diff --git a/content/en/content-management/image-processing/index.md b/content/en/content-management/image-processing/index.md
index 841f12863..3cd02aa8d 100644
--- a/content/en/content-management/image-processing/index.md
+++ b/content/en/content-management/image-processing/index.md
@@ -88,15 +88,15 @@ Example 3: A more concise way to skip image rendering if the resource is not fou
Example 4: Skips rendering if there's problem accessing a remote resource.
```go-html-template
-{{ $u := "https://gohugo.io/img/hugo-logo.png" }}
-{{ with resources.GetRemote $u }}
+{{ $url := "https://gohugo.io/img/hugo-logo.png" }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $u }}
{{ end }}
```
diff --git a/content/en/content-management/related.md b/content/en/content-management/related.md
index 44b115a64..16a8ea428 100644
--- a/content/en/content-management/related.md
+++ b/content/en/content-management/related.md
@@ -157,22 +157,3 @@ pattern
toLower
: (`bool`) See above.
-
-## Performance considerations
-
-**Fast is Hugo's middle name** and we would not have released this feature had it not been blistering fast.
-
-This feature has been in the back log and requested by many for a long time. The development got this recent kick start from this Twitter thread:
-
-{{< tweet user="scott_lowe" id="898398437527363585" >}}
-
-Scott S. Lowe removed the "Related Content" section built using the `intersect` template function on tags, and the build time dropped from 30 seconds to less than 2 seconds on his 1700 content page sized blog.
-
-He should now be able to add an improved version of that "Related Content" section without giving up the fast live-reloads. But it's worth noting that:
-
-* If you don't use any of the `Related` methods, you will not use the Relate Content feature, and performance will be the same as before.
-* Calling `.RegularPages.Related` etc. will create one inverted index, also sometimes named posting list, that will be reused for any lookups in that same page collection. Doing that in addition to, as an example, calling `.Pages.Related` will work as expected, but will create one additional inverted index. This should still be very fast, but worth having in mind, especially for bigger sites.
-
-{{% note %}}
-We currently do not index **Page content**. We thought we would release something that will make most people happy before we start solving [Sherlock's last case](https://github.com/joearms/sherlock).
-{{% /note %}}
diff --git a/content/en/content-management/shortcodes.md b/content/en/content-management/shortcodes.md
index afe84e79b..a486f0c8f 100644
--- a/content/en/content-management/shortcodes.md
+++ b/content/en/content-management/shortcodes.md
@@ -498,8 +498,6 @@ Rendered:
{{% note %}}
To override Hugo's embedded `twitter` shortcode, copy the [source code] to a file with the same name in the layouts/shortcodes directory.
-You may call the `twitter` shortcode by using its `tweet` alias.
-
[source code]: {{% eturl twitter %}}
{{% /note %}}
diff --git a/content/en/functions/data/GetCSV.md b/content/en/functions/data/GetCSV.md
index 665b3c23b..bef1bcba9 100644
--- a/content/en/functions/data/GetCSV.md
+++ b/content/en/functions/data/GetCSV.md
@@ -134,16 +134,16 @@ Consider using the [`resources.GetRemote`] function with [`transform.Unmarshal`]
```go-html-template
{{ $data := dict }}
-{{ $u := "https://example.org/pets.csv" }}
-{{ with resources.GetRemote $u }}
+{{ $url := "https://example.org/pets.csv" }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ $opts := dict "delimiter" "," }}
{{ $data = . | transform.Unmarshal $opts }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $u }}
{{ end }}
```
diff --git a/content/en/functions/data/GetJSON.md b/content/en/functions/data/GetJSON.md
index 6139e0009..0713e9247 100644
--- a/content/en/functions/data/GetJSON.md
+++ b/content/en/functions/data/GetJSON.md
@@ -137,15 +137,15 @@ Consider using the [`resources.GetRemote`] function with [`transform.Unmarshal`]
```go-html-template
{{ $data := dict }}
-{{ $u := "https://example.org/books.json" }}
-{{ with resources.GetRemote $u }}
+{{ $url := "https://example.org/books.json" }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ $data = . | transform.Unmarshal }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $u }}
{{ end }}
```
diff --git a/content/en/functions/encoding/Base64Decode.md b/content/en/functions/encoding/Base64Decode.md
index 821ca805a..0745718bb 100644
--- a/content/en/functions/encoding/Base64Decode.md
+++ b/content/en/functions/encoding/Base64Decode.md
@@ -25,16 +25,16 @@ https://api.github.com/repos/gohugoio/hugo/readme
To retrieve and render the content:
```go-html-template
-{{ $u := "https://api.github.com/repos/gohugoio/hugo/readme" }}
-{{ with resources.GetRemote $u }}
+{{ $url := "https://api.github.com/repos/gohugoio/hugo/readme" }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value}}
{{ with . | transform.Unmarshal }}
{{ .content | base64Decode | markdownify }}
{{ end }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $u }}
{{ end }}
```
diff --git a/content/en/functions/go-template/return.md b/content/en/functions/go-template/return.md
index 6916827e6..85a9f2742 100644
--- a/content/en/functions/go-template/return.md
+++ b/content/en/functions/go-template/return.md
@@ -13,7 +13,7 @@ action:
toc: true
---
-The `return` statement is a custom addition to Go's [text/template] package. Used within partial templates, the `return` statement terminates template execution and returns the given value, if any.
+The `return` statement is a non-standard extension to Go's [text/template package]. Used within partial templates, the `return` statement terminates template execution and returns the given value, if any.
The returned value may be of any data type including, but not limited to, [`bool`], [`float`], [`int`], [`map`], [`resource`], [`slice`], and [`string`].
diff --git a/content/en/functions/go-template/try.md b/content/en/functions/go-template/try.md
new file mode 100644
index 000000000..2d2aa4268
--- /dev/null
+++ b/content/en/functions/go-template/try.md
@@ -0,0 +1,110 @@
+---
+title: try
+description: Returns a TryValue object after evaluating the given expression.
+categories: []
+keywords: []
+action:
+ aliases: []
+ related: []
+ returnType: TryValue
+ signatures: ['try EXPRESSION']
+toc: true
+---
+
+{{< new-in 0.141.0 >}}
+
+The `try` statement is a non-standard extension to Go's [text/template] package. It introduces a mechanism for handling errors within templates, mimicking the `try-catch` constructs found in other programming languages.
+
+[text/template]: https://pkg.go.dev/text/template
+
+## Methods
+
+The `TryValue` object encapsulates the result of evaluating the expression, and provides two methods:
+
+Err
+: (`string`) Returns a string representation of the error thrown by the expression, if an error occurred, or returns `nil` if the expression evaluated without errors.
+
+Value
+: (`any`) Returns the result of the expression if the evaluation was successful, or returns `nil` if an error occurred while evaluating the expression.
+
+## Explanation
+
+By way of example, let's divide a number by zero:
+
+```go-html-template
+{{ $x := 1 }}
+{{ $y := 0 }}
+{{ $result := div $x $y }}
+{{ printf "%v divided by %v equals %v" $x $y .Value }}
+```
+
+As expected, the example above throws an error and fails the build:
+
+```terminfo
+Error: error calling div: can't divide the value by 0
+```
+
+Instead of failing the build, we can catch the error and emit a warning:
+
+```go-html-template
+{{ $x := 1 }}
+{{ $y := 0 }}
+{{ with try (div $x $y) }}
+ {{ with .Err }}
+ {{ warnf "%s" . }}
+ {{ else }}
+ {{ printf "%v divided by %v equals %v" $x $y .Value }}
+ {{ end }}
+{{ end }}
+```
+
+The error thrown by the expression is logged to the console as a warning:
+
+```terminfo
+WARN error calling div: can't divide the value by 0
+```
+
+Now let's change the arguments to avoid dividing by zero:
+
+```go-html-template
+{{ $x := 42 }}
+{{ $y := 6 }}
+{{ with try (div $x $y) }}
+ {{ with .Err }}
+ {{ warnf "%s" . }}
+ {{ else }}
+ {{ printf "%v divided by %v equals %v" $x $y .Value }}
+ {{ end }}
+{{ end }}
+```
+
+Hugo renders the above to:
+
+```html
+42 divided by 6 equals 7
+```
+
+## Example
+
+Error handling is essential when using the [`resources.GetRemote`] function to capture remote resources such as data or images. When calling this function, if the HTTP request fails, Hugo will fail the build.
+
+[`resources.GetRemote`]: /functions/resources/getremote/
+
+Instead of failing the build, we can catch the error and emit a warning:
+
+```go-html-template
+{{ $url := "https://broken-example.org/images/a.jpg" }}
+{{ with try (resources.GetRemote $url) }}
+ {{ with .Err }}
+ {{ warnf "%s" . }}
+ {{ else with .Value }}
+
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
+ {{ end }}
+{{ end }}
+```
+
+{{% note %}}
+Hugo does not classify an HTTP response with status code 404 as an error. In this case `resources.GetRemote` returns nil.
+{{% /note %}}
diff --git a/content/en/functions/images/Mask.md b/content/en/functions/images/Mask.md
new file mode 100644
index 000000000..b7410574c
--- /dev/null
+++ b/content/en/functions/images/Mask.md
@@ -0,0 +1,45 @@
+---
+title: images.Mask
+description: Returns an image filter that applies a mask to the source image.
+categories: []
+keywords: []
+action:
+ aliases: []
+ related:
+ - functions/images/Filter
+ - methods/resource/Filter
+ returnType: images.filter
+ signatures: [images.Mask RESOURCE]
+toc: true
+---
+
+{{< new-in 0.141.0 >}}
+
+The `images.Mask` filter applies a mask to an image. Black pixels in the mask make the corresponding areas of the base image transparent, while white pixels keep them opaque. Color images are converted to grayscale for masking purposes. The mask is automatically resized to match the dimensions of the base image.
+
+## Usage
+
+Create the filter:
+
+```go-html-template
+{{ $filter := images.Mak "images/mask.png" }}
+```
+
+{{% include "functions/images/_common/apply-image-filter.md" %}}
+
+## Example
+
+Mask
+
+{{< img
+ src="images/examples/mask.png"
+ example=false
+>}}
+
+{{< img
+ src="images/examples/zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="mask"
+ filterArgs="images/examples/mask.png"
+ example=true
+>}}
diff --git a/content/en/functions/images/Text.md b/content/en/functions/images/Text.md
index 6a18468b7..402f04f3c 100644
--- a/content/en/functions/images/Text.md
+++ b/content/en/functions/images/Text.md
@@ -52,14 +52,14 @@ Capture the font as a resource:
```go-html-template
{{ $font := "" }}
{{ $path := "https://github.com/google/fonts/raw/main/ofl/lato/Lato-Regular.ttf" }}
-{{ with resources.GetRemote $path }}
+{{ with try (resources.GetRemote $path) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ $font = . }}
+ {{ else }}
+ {{ errorf "Unable to get resource %q" $path }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get resource %q" $path }}
{{ end }}
```
diff --git a/content/en/functions/openapi3/Unmarshal.md b/content/en/functions/openapi3/Unmarshal.md
index 433337aef..d1e251800 100644
--- a/content/en/functions/openapi3/Unmarshal.md
+++ b/content/en/functions/openapi3/Unmarshal.md
@@ -22,14 +22,14 @@ For example, to work with a remote [OpenAPI] definition:
```go-html-template
{{ $url := "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json" }}
{{ $api := "" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ $api = . | openapi3.Unmarshal }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
diff --git a/content/en/functions/resources/GetRemote.md b/content/en/functions/resources/GetRemote.md
index 2179415dd..7ad56f19c 100644
--- a/content/en/functions/resources/GetRemote.md
+++ b/content/en/functions/resources/GetRemote.md
@@ -20,14 +20,14 @@ toc: true
```go-html-template
{{ $url := "https://example.org/images/a.jpg" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
@@ -75,14 +75,14 @@ When retrieving remote data, use the [`transform.Unmarshal`] function to [unmars
```go-html-template
{{ $data := dict }}
{{ $url := "https://example.org/books.json" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ $data = . | transform.Unmarshal }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
@@ -98,24 +98,24 @@ In these cases, pass the resource `Content` through the `transform.Unmarshal` fu
## Error handling
-The [`Err`] method on a resource returned by the `resources.GetRemote` function returns an error message if the HTTP request fails, else nil. If you do not handle the error yourself, Hugo will fail the build.
+Use the [`try`] statement to capture HTTP request errors. If you do not handle the error yourself, Hugo will fail the build.
-[`Err`]: /methods/resource/err/
+[`try`]: /functions/go-template/try
{{% note %}}
-Hugo does not classify an HTTP response with status code 404 as an error. In this case the function returns nil.
+Hugo does not classify an HTTP response with status code 404 as an error. In this case `resources.GetRemtoe`returns nil.
{{% /note %}}
```go-html-template
{{ $url := "https://broken-example.org/images/a.jpg" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
@@ -123,14 +123,14 @@ To log an error as a warning instead of an error:
```go-html-template
{{ $url := "https://broken-example.org/images/a.jpg" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ warnf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
+ {{ else }}
+ {{ warnf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
@@ -142,10 +142,10 @@ The [`Data`] method on a resource returned by the `resources.GetRemote` function
```go-html-template
{{ $url := "https://example.org/images/a.jpg" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ with .Data }}
{{ .ContentLength }} → 42764
{{ .ContentType }} → image/jpeg
@@ -153,9 +153,9 @@ The [`Data`] method on a resource returned by the `resources.GetRemote` function
{{ .StatusCode }} → 200
{{ .TransferEncoding }} → []
{{ end }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
diff --git a/content/en/functions/transform/ToMath.md b/content/en/functions/transform/ToMath.md
index bbdc7b289..7ffb4c379 100644
--- a/content/en/functions/transform/ToMath.md
+++ b/content/en/functions/transform/ToMath.md
@@ -97,11 +97,11 @@ There are 3 ways to handle errors from KaTeX:
1. Set the `throwOnError` option to `false` to make KaTeX render the expression as an error instead of throwing an error. See [options](#options).
{{< code file=layouts/_default/_markup/render-passthrough-inline.html copy=true >}}
-{{ with transform.ToMath .Inner }}
+{{ with try (transform.ToMath .Inner) }}
{{ with .Err }}
{{ errorf "Failed to render KaTeX: %q. See %s" . $.Position }}
{{ else }}
- {{ . }}
+ {{ .Value }}
{{ end }}
{{ end }}
{{- /* chomp trailing newline */ -}}
diff --git a/content/en/functions/transform/Unmarshal.md b/content/en/functions/transform/Unmarshal.md
index 960332c44..20505d1b6 100644
--- a/content/en/functions/transform/Unmarshal.md
+++ b/content/en/functions/transform/Unmarshal.md
@@ -97,14 +97,14 @@ A remote resource is a file on a remote server, accessible via HTTP or HTTPS.
```go-html-template
{{ $data := dict }}
{{ $url := "https://example.org/books.json" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ $data = . | transform.Unmarshal }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
{{ range where $data "author" "Victor Hugo" }}
@@ -175,14 +175,14 @@ Get the remote data:
```go-html-template
{{ $data := dict }}
{{ $url := "https://example.org/books/index.xml" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ $data = . | transform.Unmarshal }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
diff --git a/content/en/getting-started/configuration.md b/content/en/getting-started/configuration.md
index 3d75e7dd2..6fb09c164 100644
--- a/content/en/getting-started/configuration.md
+++ b/content/en/getting-started/configuration.md
@@ -266,6 +266,9 @@ To remain consistent and prevent unexpected behavior, do not mix these strategie
(`string`) The directory from where Hugo reads data files. Default is `data`. {{% module-mounts-note %}}
+###### defaultOutputFormat
+(`string`) The default output format for the site. If unspecified, the first available format in the defined order (by weight, then alphabetically) will be used.
+
###### defaultContentLanguage
(`string`) Content without language indicator will default to this language. Default is `en`.
diff --git a/content/en/methods/resource/Data.md b/content/en/methods/resource/Data.md
index 43108fce8..f62de34d2 100644
--- a/content/en/methods/resource/Data.md
+++ b/content/en/methods/resource/Data.md
@@ -17,10 +17,10 @@ The `Data` method on a resource returned by the [`resources.GetRemote`] function
```go-html-template
{{ $url := "https://example.org/images/a.jpg" }}
-{{ with resources.GetRemote $url }}
+{{ with try (resources.GetRemote $url) }}
{{ with .Err }}
{{ errorf "%s" . }}
- {{ else }}
+ {{ else with .Value }}
{{ with .Data }}
{{ .ContentLength }} → 42764
{{ .ContentType }} → image/jpeg
@@ -28,9 +28,9 @@ The `Data` method on a resource returned by the [`resources.GetRemote`] function
{{ .StatusCode }} → 200
{{ .TransferEncoding }} → []
{{ end }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
-{{ else }}
- {{ errorf "Unable to get remote resource %q" $url }}
{{ end }}
```
@@ -49,5 +49,4 @@ StatusCode
TransferEncoding
: (`string`) The transfer encoding.
-
[`resources.GetRemote`]: /functions/resources/getremote/
diff --git a/content/en/methods/resource/Err.md b/content/en/methods/resource/Err.md
index 6baa30e47..41259bf47 100644
--- a/content/en/methods/resource/Err.md
+++ b/content/en/methods/resource/Err.md
@@ -9,8 +9,15 @@ action:
- methods/resource/Data
returnType: resource.resourceError
signatures: [RESOURCE.Err]
+expiryDate: 2026-01-31
---
+{{% deprecated-in 0.141.0 %}}
+Use the `try` statement instead. See [example].
+
+[example]: /functions/go-template/try/#example
+{{% /deprecated-in %}}
+
The `Err` method on a resource returned by the [`resources.GetRemote`] function returns an error message if the HTTP request fails, else nil. If you do not handle the error yourself, Hugo will fail the build.
[`resources.GetRemote`]: /functions/resources/getremote/
diff --git a/content/en/showcase/letsencrypt/index.md b/content/en/showcase/letsencrypt/index.md
index 6ad4b7840..e2f8e168f 100644
--- a/content/en/showcase/letsencrypt/index.md
+++ b/content/en/showcase/letsencrypt/index.md
@@ -9,7 +9,7 @@ byline: "[bep](https://github.com/bep), Hugo Lead"
The **Let’s Encrypt website** has a common set of elements: A landing page and some other static info-pages, a document section, a blog, and a documentation section. Having it moved to Hugo was mostly motivated by a _simpler administration and Hugo's [multilingual support](/content-management/multilingual/)_. They already serve HTTPS to more than 60 million domains, and having the documentation available in more languages will increase that reach.[^1]
-{{< tweet user="letsencrypt" id="971755920639307777" >}}
+{{< x user="letsencrypt" id="971755920639307777" >}}
I helped them port the site from Jekyll to Hugo. There are usually very few surprises doing this. I know Hugo very well, but working on sites with a history usually comes up with something new.
diff --git a/content/en/templates/partial.md b/content/en/templates/partial.md
index 30055e7e3..996914b05 100644
--- a/content/en/templates/partial.md
+++ b/content/en/templates/partial.md
@@ -27,8 +27,7 @@ layouts/
├── head/
│ ├── favicons.html
│ ├── metadata.html
- │ ├── prerender.html
- │ └── twitter.html
+ │ └── prerender.html
└── header/
├── site-header.html
└── site-nav.html
diff --git a/data/docs.yaml b/data/docs.yaml
index 73a17ab06..27b1b0a6f 100644
--- a/data/docs.yaml
+++ b/data/docs.yaml
@@ -54,6 +54,9 @@ chroma:
- Aliases:
- armasm
Name: ArmAsm
+ - Aliases:
+ - atl
+ Name: ATL
- Aliases:
- autohotkey
- ahk
@@ -88,6 +91,9 @@ chroma:
- dosbatch
- winbatch
Name: Batchfile
+ - Aliases:
+ - beef
+ Name: Beef
- Aliases:
- bib
- bibtex
@@ -190,6 +196,9 @@ chroma:
- Aliases:
- css
Name: CSS
+ - Aliases:
+ - csv
+ Name: CSV
- Aliases:
- cue
Name: CUE
@@ -308,7 +317,7 @@ chroma:
- Gherkin
Name: Gherkin
- Aliases:
- - gleam>
+ - gleam
Name: Gleam
- Aliases:
- glsl
@@ -414,6 +423,12 @@ chroma:
- Aliases:
- json
Name: JSON
+ - Aliases:
+ - jsonata
+ Name: JSONata
+ - Aliases:
+ - jsonnet
+ Name: Jsonnet
- Aliases:
- julia
- jl
@@ -464,7 +479,8 @@ chroma:
Name: Matlab
- Aliases:
- mcfunction
- Name: mcfunction
+ - mcf
+ Name: MCFunction
- Aliases:
- meson
- meson.build
@@ -521,6 +537,11 @@ chroma:
- nixos
- nix
Name: Nix
+ - Aliases:
+ - nsis
+ - nsi
+ - nsh
+ Name: NSIS
- Aliases:
- objective-c
- objectivec
@@ -752,6 +773,9 @@ chroma:
- Aliases:
- smarty
Name: Smarty
+ - Aliases:
+ - snbt
+ Name: SNBT
- Aliases:
- snobol
Name: Snobol
@@ -862,6 +886,9 @@ chroma:
- Aliases:
- typoscripthtmldata
Name: TypoScriptHtmlData
+ - Aliases:
+ - typst
+ Name: Typst
- Aliases: null
Name: ucode
- Aliases:
@@ -904,6 +931,9 @@ chroma:
- Aliases:
- wgsl
Name: WebGPU Shading Language
+ - Aliases:
+ - vtt
+ Name: WebVTT
- Aliases:
- whiley
Name: Whiley
@@ -993,6 +1023,7 @@ config:
dataDir: data
defaultContentLanguage: en
defaultContentLanguageInSubdir: false
+ defaultOutputFormat: html
deployment:
confirm: false
dryRun: false
@@ -1146,7 +1177,6 @@ config:
lineNos: false
lineNumbersInTable: true
noClasses: true
- noHl: false
style: monokai
tabWidth: 4
wrapperClass: highlight
@@ -3196,6 +3226,11 @@ tpl:
Args: null
Description: ""
Examples: null
+ Mask:
+ Aliases: null
+ Args: null
+ Description: ""
+ Examples: null
Opacity:
Aliases: null
Args: null
@@ -3221,6 +3256,11 @@ tpl:
Args: null
Description: ""
Examples: null
+ QR:
+ Aliases: null
+ Args: null
+ Description: ""
+ Examples: null
Saturation:
Aliases: null
Args: null
diff --git a/data/embedded_template_urls.toml b/data/embedded_template_urls.toml
index 359105e60..68be43d88 100644
--- a/data/embedded_template_urls.toml
+++ b/data/embedded_template_urls.toml
@@ -36,4 +36,5 @@
'relref' = 'shortcodes/relref.html'
'twitter' = 'shortcodes/twitter.html'
'vimeo' = 'shortcodes/vimeo.html'
+'x' = 'shortcodes/x.html'
'youtube' = 'shortcodes/youtube.html'
diff --git a/hugo_stats.json b/hugo_stats.json
deleted file mode 100644
index ca27d8991..000000000
--- a/hugo_stats.json
+++ /dev/null
@@ -1,820 +0,0 @@
-{
- "htmlElements": {
- "tags": [
- "",
- "a",
- "article",
- "aside",
- "blockquote",
- "body",
- "br",
- "button",
- "circle",
- "code",
- "date",
- "dd",
- "div",
- "dl",
- "dt",
- "em",
- "figcaption",
- "figure",
- "footer",
- "form",
- "g",
- "h1",
- "h2",
- "h3",
- "h4",
- "h5",
- "h6",
- "head",
- "header",
- "hr",
- "html",
- "i",
- "iframe",
- "img",
- "li",
- "link",
- "main",
- "meta",
- "nav",
- "noscript",
- "ol",
- "p",
- "path",
- "pre",
- "script",
- "section",
- "small",
- "span",
- "strong",
- "style",
- "sup",
- "svg",
- "table",
- "tbody",
- "td",
- "thead",
- "time",
- "title",
- "tr",
- "ul"
- ],
- "classes": [
- "!('about'",
- "!('content-management'",
- "!('contribute'",
- "!('functions'",
- "!('getting-started'",
- "!('hosting-and-deployment'",
- "!('modules'",
- "!('pipes'",
- "!('templates'",
- "!('tools'",
- "!('troubleshooting'",
- "!('variables'",
- "\u0026\u0026",
- "(false",
- "(true",
- "-ml-px",
- "-mr-12",
- "-mr-3",
- "-translate-x-3",
- "-translate-y-2",
- "absolute",
- "absolute-l",
- "active",
- "admonition",
- "admonition-content",
- "admonition-icon",
- "anchor",
- "b--moon-gray",
- "benchstat",
- "better",
- "bg-accent-color-dark",
- "bg-animate",
- "bg-black",
- "bg-carrot-500",
- "bg-cover",
- "bg-gradient-to-b",
- "bg-gray-100",
- "bg-gray-200",
- "bg-gray-300",
- "bg-gray-50",
- "bg-gray-600",
- "bg-gray-900",
- "bg-green-100",
- "bg-mango-300",
- "bg-mango-50",
- "bg-near-white",
- "bg-opacity-20",
- "bg-opacity-75",
- "bg-orange-500",
- "bg-steel-200",
- "bg-steel-500",
- "bg-steel-600",
- "bg-steel-800",
- "bg-steel-900",
- "bg-white",
- "blTK",
- "black",
- "block",
- "bmt1",
- "border",
- "border-0",
- "border-2",
- "border-b",
- "border-gray-100",
- "border-gray-200",
- "border-gray-300",
- "border-l",
- "border-none",
- "border-r",
- "border-solid",
- "border-t",
- "border-transparent",
- "bottom-0",
- "break-inside-avoid-l",
- "btn-primary",
- "c",
- "c1",
- "chroma",
- "clearfix",
- "cm",
- "code-copy-content",
- "code-toggle",
- "column-count-3-l",
- "column-gap-1-l",
- "configs",
- "copy",
- "cp",
- "cursor-pointer",
- "dark:bg-red-800",
- "dark:border-gray-800",
- "delta",
- "details",
- "dim",
- "disabled",
- "divide-gray-200",
- "divide-x",
- "err",
- "f2-fluid",
- "f6",
- "filename",
- "fill-current",
- "fixed",
- "fixed-lTK",
- "flex",
- "flex-1",
- "flex-auto",
- "flex-auto-ns",
- "flex-col",
- "flex-column",
- "flex-none",
- "flex-shrink-0",
- "flex-wrap",
- "fn",
- "focus:border-steel-500",
- "focus:outline-none",
- "focus:ring-1",
- "focus:ring-2",
- "focus:ring-inset",
- "focus:ring-offset-2",
- "focus:ring-steel-500",
- "focus:ring-white",
- "focus:z-10",
- "font-black",
- "font-bold",
- "font-extrabold",
- "font-extralight",
- "font-medium",
- "font-mono",
- "font-normal",
- "font-sans",
- "font-semibold",
- "footnote-backref",
- "footnote-ref",
- "footnotes",
- "from-primarydark",
- "gap-4",
- "ge",
- "grid",
- "grid-cols-1",
- "group",
- "grow",
- "gs",
- "gu",
- "h-0",
- "h-0.5",
- "h-10",
- "h-12",
- "h-16",
- "h-2",
- "h-32",
- "h-5",
- "h-6",
- "h-64",
- "h-8",
- "h-full",
- "h-screen",
- "h6",
- "hidden",
- "highlight",
- "hl",
- "hover",
- "hover-bg-green",
- "hover-bg-near-white",
- "hover-bg-primary-color",
- "hover-bg-primary-color-dark",
- "hover-blue",
- "hover:bg-gray-300",
- "hover:bg-gray-50",
- "hover:bg-steel-500",
- "hover:bg-steel-700",
- "hover:border",
- "hover:text-gray-200",
- "hover:text-gray-900",
- "hover:text-hotpink-400",
- "hover:text-hotpink-600",
- "hover:text-limegreen-900",
- "hover:text-royalblue-700",
- "hover:text-steel-500",
- "hover:text-white",
- "img",
- "in",
- "inline-block",
- "inline-flex",
- "inset-0",
- "inset-x-0",
- "instagram-media",
- "items-center",
- "items-start",
- "justify-between",
- "justify-center",
- "justify-end",
- "k",
- "kc",
- "kd",
- "kr",
- "kt",
- "l",
- "language-asciidoc",
- "language-bash",
- "language-go",
- "language-go-html-template",
- "language-go-text-template",
- "language-html",
- "language-js",
- "language-json",
- "language-markdown",
- "language-md",
- "language-ps1",
- "language-sh",
- "language-svg",
- "language-text",
- "language-toml",
- "language-txt",
- "language-xml",
- "language-yaml",
- "language-yml",
- "lazyload",
- "ld",
- "lead",
- "leading-none",
- "leading-normal",
- "leading-relaxed",
- "leading-snug",
- "leading-tight",
- "left-0",
- "lg:bg-steel-700",
- "lg:block",
- "lg:flex",
- "lg:flex-grow",
- "lg:flex-shrink-0",
- "lg:hidden",
- "lg:inline-block",
- "lg:items-center",
- "lg:max-w-lg",
- "lg:mb-0",
- "lg:mr-auto",
- "lg:mt-0",
- "lg:p-4",
- "lg:pb-5",
- "lg:prose-lg",
- "lg:pt-0",
- "lg:px-4",
- "lg:px-5",
- "lg:px-8",
- "lg:py-5",
- "lg:py-8",
- "lg:rounded-md",
- "lg:shadow-lg",
- "lg:space-x-4",
- "lg:text-5xl",
- "lg:w-1/2",
- "lg:w-1/4",
- "lg:w-1/5",
- "lg:w-11/12",
- "lg:w-3/5",
- "lg:w-4/5",
- "lg:w-auto",
- "light-gray",
- "link",
- "list-reset",
- "lnt",
- "lntable",
- "lntd",
- "m",
- "m-0",
- "m-1",
- "max-w-6xl",
- "max-w-lg",
- "max-w-xs",
- "mb-0",
- "mb-1",
- "mb-2",
- "mb-3",
- "mb-4",
- "mb-8",
- "mb5",
- "mb7",
- "md:flex",
- "md:flex-col",
- "md:flex-grow",
- "md:grid-cols-2",
- "md:mt-8",
- "md:pb-12",
- "menu))",
- "menu['about']",
- "menu['content-management']",
- "menu['contribute']",
- "menu['functions']",
- "menu['getting-started']",
- "menu['hosting-and-deployment']",
- "menu['modules']",
- "menu['pipes']",
- "menu['templates']",
- "menu['tools']",
- "menu['troubleshooting']",
- "menu['variables']",
- "mf",
- "mi",
- "min-h-screen",
- "min-w-0",
- "minor",
- "ml-1",
- "ml-10",
- "ml-4",
- "ml-6",
- "ml1",
- "mr-1.5",
- "mr-10",
- "mr-3",
- "mr-4",
- "mt-0",
- "mt-1",
- "mt-2",
- "mt-4",
- "mt-5",
- "mt-6",
- "mt-8",
- "mt3",
- "mt4",
- "mv2",
- "mv3",
- "mv4",
- "mv6",
- "mw-100",
- "mw5-l",
- "mx-auto",
- "my-0",
- "n",
- "na",
- "navbar-menu",
- "nb",
- "needs-js",
- "nested-blockquote",
- "nested-copy-seperator",
- "nested-img",
- "nested-links",
- "nested-linksTK",
- "nested-list-reset",
- "nf",
- "ni",
- "nightwind",
- "nightwind-prevent",
- "nightwind-prevent-block",
- "nn",
- "no-js",
- "no-underline",
- "nodelta",
- "note",
- "note-icon",
- "nt",
- "nt3",
- "nv",
- "nx",
- "o",
- "o-0",
- "o-80",
- "oldnew",
- "opacity-60",
- "open",
- "order-0",
- "order-0-l",
- "order-1",
- "order-1-l",
- "order-2",
- "output-content",
- "overflow-hidden",
- "overflow-x-scroll",
- "overflow-y-auto",
- "p",
- "p-0",
- "p-2",
- "p-3",
- "p-4",
- "p-5",
- "p-8",
- "pa4-m",
- "page-item",
- "page-link",
- "pagination",
- "pb-1",
- "pb-2",
- "pb-3",
- "pb-4",
- "pb-5",
- "pb-7",
- "pb-8",
- "pb2",
- "ph1",
- "ph2",
- "ph4",
- "pl-0",
- "pl-1",
- "pl-2",
- "pl-3",
- "pl-6",
- "pl5-l",
- "pr-2",
- "pr1",
- "primary-color",
- "prose",
- "pt-0",
- "pt-1",
- "pt-2",
- "pt-3",
- "pt-4",
- "pt-5",
- "pv1",
- "px-0",
- "px-2",
- "px-3",
- "px-4",
- "py-0",
- "py-0.5",
- "py-1.5",
- "py-2",
- "py-3",
- "py-4",
- "py-6",
- "relative",
- "right-0",
- "rounded",
- "rounded-full",
- "rounded-l-lg",
- "rounded-l-md",
- "rounded-lg",
- "rounded-md",
- "rounded-r-md",
- "row",
- "s",
- "s1",
- "s2",
- "san-serif",
- "se",
- "shadow",
- "shadow-lg",
- "shadow-md",
- "shadow-sm",
- "show",
- "sm:flex",
- "sm:grid-cols-2",
- "sm:mb-0",
- "sm:mt-0",
- "sm:mt-8",
- "sm:p-4",
- "sm:pb-0",
- "sm:pb-6",
- "sm:pt-3",
- "sm:pt-5",
- "sm:px-4",
- "sm:px-5",
- "sm:px-6",
- "sm:py-0",
- "sm:py-4",
- "sm:py-5",
- "sm:py-6",
- "sm:text-2xl",
- "sm:text-4xl",
- "sm:text-base",
- "sm:text-center",
- "sm:text-left",
- "sm:w-1/2",
- "sm:w-1/5",
- "sm:w-11/12",
- "sm:w-4/5",
- "space-x-4",
- "space-x-8",
- "space-y-1",
- "sr-only",
- "table",
- "table-bordered",
- "tc",
- "text-2xl",
- "text-3xl",
- "text-4xl",
- "text-5xl",
- "text-base",
- "text-black",
- "text-center",
- "text-gray-200",
- "text-gray-300",
- "text-gray-400",
- "text-gray-500",
- "text-gray-600",
- "text-gray-900",
- "text-lg",
- "text-limegreen-600",
- "text-limegreen-700",
- "text-mango-100",
- "text-mango-300",
- "text-md",
- "text-royalblue-500",
- "text-royalblue-600",
- "text-sm",
- "text-steel-100",
- "text-steel-500",
- "text-steel-900",
- "text-white",
- "text-xl",
- "text-xs",
- "tile",
- "tip",
- "tip-icon",
- "to-steel-800",
- "top-0",
- "top-2",
- "tracked",
- "tracking-normal",
- "tracking-tight",
- "transform",
- "twitter-tweet",
- "unchanged",
- "uppercase",
- "v-base",
- "v-mid",
- "v-top",
- "w",
- "w-1/5",
- "w-10",
- "w-11/12",
- "w-12",
- "w-14",
- "w-2",
- "w-2/3",
- "w-30-l",
- "w-32",
- "w-5",
- "w-50-m",
- "w-6",
- "w-64",
- "w-8",
- "w-80-nsTK",
- "w-96",
- "w-auto",
- "w-full",
- "w-two-third-l",
- "warning",
- "whitespace-no-wrap",
- "worse",
- "x",
- "xl:flex",
- "xl:flex-col",
- "z-0",
- "z-40",
- "z-999",
- "||"
- ],
- "ids": [
- ".gitlab-ci.yml",
- "/blog/greatest-city/index.html",
- "/content/actors/bruce-willis/_index.md",
- "/layouts/shortcodes/img.html",
- "/layouts/shortcodes/vimeo.html",
- "/layouts/shortcodes/year.html",
- "/layouts/shortcodes/youtube.html",
- "/themes/yourtheme/layouts/review/single.html",
- "404.html",
- "TableOfContents",
- "addrobotstxt.sh",
- "all-taxonomies-keys-and-pages.html",
- "all-taxonomies.html",
- "archetype-example.sh",
- "archetypes/functions.md",
- "archetypes/newsletter.md",
- "articles.html",
- "asciicast-3mf1JGaN0AX0Z7j5kLGl3hSh8",
- "asciicast-7naKerRYUGVPj8kiDmdh5k5h9",
- "asciicast-BvJBsF6egk9c163bMsObhuNXj",
- "asciicast-ItACREbFgvJ0HjnSNeTknxWy9",
- "asciicast-Lc5iwTVny2kuUC8lqvNnL6oDU",
- "asciicast-eUojYCfRTZvkEiqc52fUsJRBR",
- "bad-url-sidebar-menu-output.html",
- "base-64-output.html",
- "base64-input.html",
- "baseof.html",
- "bf-config.toml",
- "bf-config.yml",
- "boxfile.yml",
- "breadcrumb.html",
- "check-title-length.html",
- "clone-herring-cove-theme.sh",
- "config.toml",
- "content-header.html",
- "content-image.md",
- "content/blog/greatest-city.md",
- "content/posts/_index.md",
- "content/posts/default-function-example.md",
- "content/posts/my-awesome-post.md",
- "content/posts/my-post.md",
- "content/posts/old-post.md",
- "content/posts/old-url.md",
- "content/tutorials/learn-html.md",
- "correct-url-sidebar-menu-output.html",
- "delimit-example-front-matter.toml",
- "delimit-page-tags-final-and-input.html",
- "delimit-page-tags-final-and-output.html",
- "delimit-page-tags-input.html",
- "delimit-page-tags-output.html",
- "disqus.html",
- "dot-notation-default-return-value.html",
- "dot-notation-default-value.html",
- "example-tweet-input.md",
- "example-tweet-output.html",
- "example-vimeo-input.md",
- "example-vimeo-output.html",
- "example-youtube-input-with-autoplay.md",
- "example-youtube-input-with-title.md",
- "example-youtube-input.md",
- "example-youtube-output.html",
- "example.com/posts/index.html",
- "example.com/quote/index.html",
- "external-links.svg",
- "figure-input-example.md",
- "figure-output-example.html",
- "first-and-where-together.html",
- "fn:1",
- "fn:2",
- "fnref:1",
- "fnref:2",
- "footer.html",
- "from-gh.sh",
- "gist-input.md",
- "gist-output.html",
- "gitignore.sh",
- "gohugoio",
- "grab-top-two-tags.html",
- "header.html",
- "highlight-example.md",
- "how-many-posts.html",
- "hugo-new-site.sh",
- "if-instead-of-default.html",
- "img-output.html",
- "index.html",
- "instagram-hide-caption-output.html",
- "instagram-input-hide-caption.md",
- "instagram-input.md",
- "install-brew.sh",
- "install-extended-with-chocolatey.ps1",
- "install-go.sh",
- "install-openssh.sh",
- "install-with-chocolatey.ps1",
- "install-with-homebrew.sh",
- "install-with-linuxbrew.sh",
- "install-with-macports.sh",
- "install.sh",
- "layout/_default/section.html",
- "layout/_default/single.html",
- "layouts/404.html",
- "layouts/_default/_markup/render-heading.html",
- "layouts/_default/_markup/render-image.html",
- "layouts/_default/_markup/render-link.html",
- "layouts/_default/baseof.html",
- "layouts/_default/li.html",
- "layouts/_default/list.html",
- "layouts/_default/section.html",
- "layouts/_default/single.html",
- "layouts/_default/summary.html",
- "layouts/_default/taxonomy.html",
- "layouts/index.html",
- "layouts/partials/all-taxonomies.html",
- "layouts/partials/alllanguages.html",
- "layouts/partials/bad-url-sidebar-menu.html",
- "layouts/partials/breadcrumb.html",
- "layouts/partials/by-date-reverse.html",
- "layouts/partials/by-date.html",
- "layouts/partials/by-expiry-date.html",
- "layouts/partials/by-group-by-page.html",
- "layouts/partials/by-last-mod.html",
- "layouts/partials/by-length.html",
- "layouts/partials/by-link-title.html",
- "layouts/partials/by-nested-param.html",
- "layouts/partials/by-page-date.html",
- "layouts/partials/by-page-expiry-date.html",
- "layouts/partials/by-page-field.html",
- "layouts/partials/by-page-lastmod.html",
- "layouts/partials/by-page-param-as-date.html",
- "layouts/partials/by-page-param.html",
- "layouts/partials/by-page-publish-date.html",
- "layouts/partials/by-publish-date.html",
- "layouts/partials/by-rating.html",
- "layouts/partials/by-title.html",
- "layouts/partials/by-weight.html",
- "layouts/partials/content-header.html",
- "layouts/partials/correct-url-sidebar-menu.html",
- "layouts/partials/default-order.html",
- "layouts/partials/disqus.html",
- "layouts/partials/footer.html",
- "layouts/partials/get-csv.html",
- "layouts/partials/groups.html",
- "layouts/partials/head.html",
- "layouts/partials/header.html",
- "layouts/partials/i18nlist.html",
- "layouts/partials/post-tag-link.html",
- "layouts/partials/post-tag-list.html",
- "layouts/partials/related.html",
- "layouts/partials/schemaorg-metadata.html",
- "layouts/partials/sidebar.html",
- "layouts/partials/svgs/external-links.svg",
- "layouts/partials/toc.html",
- "layouts/partials/twitter.html",
- "layouts/partials/upcoming-events.html",
- "layouts/posts/single.html",
- "layouts/robots.txt",
- "layouts/section/articles.html",
- "layouts/section/posts.html",
- "layouts/shortcodes/gallery.html",
- "layouts/shortcodes/img.html",
- "layouts/shortcodes/imgproc.html",
- "li.html",
- "links-to-all-tags.html",
- "list.html",
- "netlify.toml",
- "note-with-heading.html",
- "note-with-heading.md",
- "page-list-with-summaries.html",
- "partial-cached-example.html",
- "partials/templates/random-tweets.html",
- "post-tag-list.html",
- "prose",
- "push-wecker-to-gh.sh",
- "range-through-tags-w-global.html",
- "remove-herring-cove-git.sh",
- "robots.txt",
- "schemaorg-metadata.html",
- "section.html",
- "setup-gh-repo.sh",
- "shuffle-input.html",
- "shuffle-output.html",
- "sidebar.html",
- "single.html",
- "slice.html",
- "summary.html",
- "syntax-highlighted.html",
- "tags-range-with-page-variable.html",
- "taxonomy.html",
- "time-passed.html",
- "tip-output.html",
- "toc.html",
- "tutorials/learn-html/index.html",
- "tweets.html",
- "unix-to-month-integer.html",
- "upcoming-events.html",
- "using-tip.md",
- "variable-as-default-value.html",
- "vimeo-iframes.html",
- "warning-admonition-input.md",
- "warning-admonition-output.html",
- "wercker-build-step.yml",
- "wercker.yml",
- "where-intersect-variables.html",
- "with-instead-of-default.html",
- "yourbaseurl/review/book01/index.html",
- "youtube-embed.html"
- ]
- }
-}
\ No newline at end of file
diff --git a/layouts/partials/components/author-github-data-card.html b/layouts/partials/components/author-github-data-card.html
new file mode 100644
index 000000000..d3edadaac
--- /dev/null
+++ b/layouts/partials/components/author-github-data-card.html
@@ -0,0 +1,43 @@
+{{ $author := .context.Params.author }}
+{{ if $author }}
+
+{{ end }}
diff --git a/layouts/partials/components/author-github-data.html b/layouts/partials/components/author-github-data.html
new file mode 100644
index 000000000..c281e411f
--- /dev/null
+++ b/layouts/partials/components/author-github-data.html
@@ -0,0 +1,36 @@
+{{ $author := .context.Params.author }}
+{{ if $author }}
+
+{{ end }}
diff --git a/layouts/partials/utilities/get-remote-data.html b/layouts/partials/utilities/get-remote-data.html
new file mode 100644
index 000000000..78b2ba06e
--- /dev/null
+++ b/layouts/partials/utilities/get-remote-data.html
@@ -0,0 +1,23 @@
+{{/*
+Parses the serialized data from the given URL and returns a map or an array.
+
+Supports CSV, JSON, TOML, YAML, and XML.
+
+@param {string} . The URL from which to retrieve the serialized data.
+@returns {any}
+
+@example {{ partial "get-remote-data.html" "https://example.org/foo.json" }}
+*/}}
+
+{{ $url := . }}
+{{ $data := dict }}
+{{ with try (resources.GetRemote $url) }}
+ {{ with .Err }}
+ {{ errorf "%s" . }}
+ {{ else with .Value }}
+ {{ $data = .Content | transform.Unmarshal }}
+ {{ else }}
+ {{ errorf "Unable to get remote resource %q" $url }}
+ {{ end }}
+{{ end }}
+{{ return $data }}
diff --git a/layouts/shortcodes/img.html b/layouts/shortcodes/img.html
new file mode 100644
index 000000000..7c2d805d2
--- /dev/null
+++ b/layouts/shortcodes/img.html
@@ -0,0 +1,391 @@
+{{- /*
+Renders the given image using the given filter, if any.
+
+@param {string} src The path to the image which must be a remote, page, or global resource.
+@param {string} [filter] The filter to apply to the image (case-insensitive).
+@param {string} [filterArgs] A comma-delimited list of arguments to pass to the filter.
+@param {bool} [example=false] If true, renders a before/after example.
+@param {int} [exampleWidth=384] Image width, in pixels, when rendering a before/after example.
+
+@returns {template.HTML}
+
+@examples
+
+ {{< img src="zion-national-park.jpg" >}}
+
+ {{< img src="zion-national-park.jpg" alt="Zion National Park" >}}
+
+ {{< img
+ src="zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="grayscale"
+ >}}
+
+ {{< img
+ src="zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="process"
+ filterArgs="resize 400x webp"
+ >}}
+
+ {{< img
+ src="zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="colorize"
+ filterArgs="180,50,20"
+ >}}
+
+ {{< img
+ src="zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="grayscale"
+ example=true
+ >}}
+
+ {{< img
+ src="zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="grayscale"
+ example=true
+ exampleWidth=400
+ >}}
+
+ When using the text filter, provide the arguments in this order:
+
+ 0. The text
+ 1. The horizontal offset, in pixels, relative to the left of the image (default 20)
+ 2. The vertical offset, in pixels, relative to the top of the image (default 20)
+ 3. The font size in pixels (default 64)
+ 4. The line height (default 1.2)
+ 5. The font color (default #ffffff)
+
+ {{< img
+ src="images/examples/zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="Text"
+ filterArgs="Zion National Park,25,250,56"
+ example=true
+ >}}
+
+ When using the padding filter, provide all arguments in this order:
+
+ 0. Padding top
+ 1. Padding right
+ 2. Padding bottom
+ 3. Padding right
+ 4. Canvas color
+
+ {{< img
+ src="images/examples/zion-national-park.jpg"
+ alt="Zion National Park"
+ filter="Padding"
+ filterArgs="20,50,20,50,#0705"
+ example=true
+ >}}
+
+*/}}
+
+{{- /* Initialize. */}}
+{{- $alt := "" }}
+{{- $src := "" }}
+{{- $filter := "" }}
+{{- $filterArgs := slice }}
+{{- $example := false }}
+{{- $exampleWidth := 384 }}
+
+{{- /* Default values to use with the text filter. */}}
+{{ $textFilterOpts := dict
+ "xOffset" 20
+ "yOffset" 20
+ "fontSize" 64
+ "lineHeight" 1.2
+ "fontColor" "#ffffff"
+ "fontPath" "https://github.com/google/fonts/raw/main/ofl/lato/Lato-Regular.ttf"
+}}
+
+{{- /* Get and validate parameters. */}}
+{{- with .Get "alt" }}
+ {{- $alt = .}}
+{{- end }}
+
+{{- with .Get "src" }}
+ {{- $src = . }}
+{{- else }}
+ {{- errorf "The %q shortcode requires a file parameter. See %s" .Name .Position }}
+{{- end }}
+
+{{- with .Get "filter" }}
+ {{- $filter = . | lower }}
+{{- end }}
+
+{{- $validFilters := slice
+ "autoorient" "brightness" "colorbalance" "colorize" "contrast" "dither"
+ "gamma" "gaussianblur" "grayscale" "hue" "invert" "mask" "none" "opacity"
+ "overlay" "padding" "pixelate" "process" "saturation" "sepia" "sigmoid" "text"
+ "unsharpmask"
+}}
+
+{{- with $filter }}
+ {{- if not (in $validFilters .) }}
+ {{- errorf "The filter passed to the %q shortcode is invalid. The filter must be one of %s. See %s" $.Name (delimit $validFilters ", " ", or ") $.Position }}
+ {{- end }}
+{{- end }}
+
+{{- with .Get "filterArgs" }}
+ {{- $filterArgs = split . "," }}
+ {{- $filterArgs = apply $filterArgs "trim" "." " " }}
+{{- end }}
+
+{{- if in (slice "false" false 0) (.Get "example") }}
+ {{- $example = false }}
+{{- else if in (slice "true" true 1) (.Get "example")}}
+ {{- $example = true }}
+{{- end }}
+
+{{- with .Get "exampleWidth" }}
+ {{- $exampleWidth = . | int }}
+{{- end }}
+
+{{- /* Get image. */}}
+{{- $ctx := dict "page" .Page "src" $src "name" .Name "position" .Position }}
+{{- $i := partial "inline/get-resource.html" $ctx }}
+
+{{- /* Resize if rendering before/after examples. */}}
+{{- if $example }}
+ {{- $i = $i.Resize (printf "%dx" $exampleWidth) }}
+{{- end }}
+
+{{- /* Create filter. */}}
+{{- $f := "" }}
+{{- $ctx := dict "filter" $filter "args" $filterArgs "name" .Name "position" .Position }}
+{{- if eq $filter "autoorient" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 0) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $f = images.AutoOrient }}
+{{- else if eq $filter "brightness" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage" "argValue" (index $filterArgs 0) "min" -100 "max" 100) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Brightness (index $filterArgs 0) }}
+{{- else if eq $filter "colorbalance" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 3) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage red" "argValue" (index $filterArgs 0) "min" -100 "max" 500) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage green" "argValue" (index $filterArgs 1) "min" -100 "max" 500) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage blue" "argValue" (index $filterArgs 2) "min" -100 "max" 500) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.ColorBalance (index $filterArgs 0) (index $filterArgs 1) (index $filterArgs 2) }}
+{{- else if eq $filter "colorize" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 3) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "hue" "argValue" (index $filterArgs 0) "min" 0 "max" 360) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $ctx = merge $ctx (dict "argName" "saturation" "argValue" (index $filterArgs 1) "min" 0 "max" 100) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage" "argValue" (index $filterArgs 2) "min" 0 "max" 100) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Colorize (index $filterArgs 0) (index $filterArgs 1) (index $filterArgs 2) }}
+{{- else if eq $filter "contrast" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage" "argValue" (index $filterArgs 0) "min" -100 "max" 100) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Contrast (index $filterArgs 0) }}
+{{- else if eq $filter "dither" }}
+ {{- $f = images.Dither }}
+{{- else if eq $filter "gamma" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "gamma" "argValue" (index $filterArgs 0) "min" 0 "max" 100) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Gamma (index $filterArgs 0) }}
+{{- else if eq $filter "gaussianblur" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "sigma" "argValue" (index $filterArgs 0) "min" 0 "max" 1000) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.GaussianBlur (index $filterArgs 0) }}
+{{- else if eq $filter "grayscale" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 0) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $f = images.Grayscale }}
+{{- else if eq $filter "hue" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "shift" "argValue" (index $filterArgs 0) "min" -180 "max" 180) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Hue (index $filterArgs 0) }}
+{{- else if eq $filter "invert" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 0) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $f = images.Invert }}
+{{- else if eq $filter "mask" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $ctx := dict "src" (index $filterArgs 0) "name" .Name "position" .Position }}
+ {{- $maskImage := partial "inline/get-resource.html" $ctx }}
+ {{- $f = images.Mask $maskImage }}
+{{- else if eq $filter "opacity" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "opacity" "argValue" (index $filterArgs 0) "min" 0 "max" 1) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Opacity (index $filterArgs 0) }}
+{{- else if eq $filter "overlay" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 3) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $ctx := dict "src" (index $filterArgs 0) "name" .Name "position" .Position }}
+ {{- $overlayImg := partial "inline/get-resource.html" $ctx }}
+ {{- $f = images.Overlay $overlayImg (index $filterArgs 1 | float ) (index $filterArgs 2 | float) }}
+{{- else if eq $filter "padding" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 5) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $f = images.Padding
+ (index $filterArgs 0 | int)
+ (index $filterArgs 1 | int)
+ (index $filterArgs 2 | int)
+ (index $filterArgs 3 | int)
+ (index $filterArgs 4)
+ }}
+{{- else if eq $filter "pixelate" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "size" "argValue" (index $filterArgs 0) "min" 0 "max" 1000) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Pixelate (index $filterArgs 0) }}
+{{- else if eq $filter "process" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $f = images.Process (index $filterArgs 0) }}
+{{- else if eq $filter "saturation" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage" "argValue" (index $filterArgs 0) "min" -100 "max" 500) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Saturation (index $filterArgs 0) }}
+{{- else if eq $filter "sepia" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "percentage" "argValue" (index $filterArgs 0) "min" 0 "max" 100) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Sepia (index $filterArgs 0) }}
+{{- else if eq $filter "sigmoid" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 2) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "midpoint" "argValue" (index $filterArgs 0) "min" 0 "max" 1) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $ctx = merge $ctx (dict "argName" "factor" "argValue" (index $filterArgs 1) "min" -10 "max" 10) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.Sigmoid (index $filterArgs 0) (index $filterArgs 1) }}
+{{- else if eq $filter "text" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 1) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $ctx := dict "src" $textFilterOpts.fontPath "name" .Name "position" .Position }}
+ {{- $font := or (partial "inline/get-resource.html" $ctx) }}
+ {{- $fontSize := or (index $filterArgs 3 | int) $textFilterOpts.fontSize }}
+ {{- $lineHeight := math.Max (or (index $filterArgs 4 | float) $textFilterOpts.lineHeight) 1 }}
+ {{- $opts := dict
+ "x" (or (index $filterArgs 1 | int) $textFilterOpts.xOffset)
+ "y" (or (index $filterArgs 2 | int) $textFilterOpts.yOffset)
+ "size" $fontSize
+ "linespacing" (mul (sub $lineHeight 1) $fontSize)
+ "color" (or (index $filterArgs 5) $textFilterOpts.fontColor)
+ "font" $font
+ }}
+ {{- $f = images.Text (index $filterArgs 0) $opts }}
+{{- else if eq $filter "unsharpmask" }}
+ {{- $ctx = merge $ctx (dict "argsRequired" 3) }}
+ {{- template "validate-arg-count" $ctx }}
+ {{- $filterArgs = apply $filterArgs "float" "." }}
+ {{- $ctx = merge $ctx (dict "argName" "sigma" "argValue" (index $filterArgs 0) "min" 0 "max" 500) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $ctx = merge $ctx (dict "argName" "amount" "argValue" (index $filterArgs 1) "min" 0 "max" 100) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $ctx = merge $ctx (dict "argName" "threshold" "argValue" (index $filterArgs 2) "min" 0 "max" 1) }}
+ {{- template "validate-arg-value" $ctx }}
+ {{- $f = images.UnsharpMask (index $filterArgs 0) (index $filterArgs 1) (index $filterArgs 2) }}
+{{- end }}
+
+{{- /* Apply filter. */}}
+{{- $fi := $i }}
+{{- with $f }}
+ {{- $fi = $i.Filter . }}
+{{- end }}
+
+{{- /* Render. */}}
+{{- $class := "di va b--black-20" }}
+{{- if eq $filter "mask" }}
+ {{- $class = "di va" }}
+{{- end }}
+{{- if $example }}
+
Original
+Processed
+