Sync and vendor theme

_vendor/github.com/gohugoio/gohugoioTheme/layouts/shortcodes/img.html

@@ -119,8 +119,8 @@ Renders the given image using the given filter, if any.
 {{- end }}
 
 {{- $validFilters := slice
-  "autoorient" "brightness" "colorbalance" "colorize" "contrast" "gamma"
-  "gaussianblur" "grayscale" "hue" "invert" "none" "opacity" "overlay"
+  "autoorient" "brightness" "colorbalance" "colorize" "contrast" "dither"
+  "gamma" "gaussianblur" "grayscale" "hue" "invert" "none" "opacity" "overlay"
   "padding" "pixelate" "process" "saturation" "sepia" "sigmoid" "text"
   "unsharpmask"
 }}
@@ -198,6 +198,8 @@ Renders the given image using the given filter, if any.
   {{- $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 }}

_vendor/github.com/gohugoio/gohugoioTheme/layouts/shortcodes/new-in.html

@@ -27,7 +27,7 @@ button will be hidden if any of the following conditions is true:
       {{- warnf "This call to the %q shortcode should be removed: %s. The button is now hidden because the specified version (%s) is older than the display threshold." $.Name $.Position $version }}
     {{- end }}
   {{- else }}
-    <button class="bg-white hover:bg-gray-100 text-gray-800 font-semibold py-2 mr2 px-4 border border-gray-400 rounded shadow">
+    <button class="bg-white hover:bg-gray-100 text-gray-800 font-semibold py-2 mr2 mt2 px-4 border border-gray-400 rounded shadow">
       <a href="{{ printf "https://github.com/gohugoio/hugo/releases/tag/v%s" $version }}">New in v{{ $version }}</a>
     </button>
   {{- end }}

_vendor/modules.txt

@@ -1 +1 @@
-# github.com/gohugoio/gohugoioTheme v0.0.0-20240201183016-8e648a3b5342
+# github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180

go.mod

@@ -2,4 +2,4 @@ module github.com/gohugoio/hugoDocs
 
 go 1.16
 
-require github.com/gohugoio/gohugoioTheme v0.0.0-20240201183016-8e648a3b5342 // indirect
+require github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180 // indirect

go.sum

@@ -1,2 +1,2 @@
-github.com/gohugoio/gohugoioTheme v0.0.0-20240201183016-8e648a3b5342 h1:jQaO+i2osHeIZ+V7Dvo7CPqN6jPwMRjt7b9QaX7HXE4=
-github.com/gohugoio/gohugoioTheme v0.0.0-20240201183016-8e648a3b5342/go.mod h1:GOYeAPQJ/ok8z7oz1cjfcSlsFpXrmx6VkzQ5RpnyhZM=
+github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180 h1:QMzk5J6Im/HG3ZeFfmy+cfn5XRZT5ZCbMGbLpcQKAfk=
+github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180/go.mod h1:GOYeAPQJ/ok8z7oz1cjfcSlsFpXrmx6VkzQ5RpnyhZM=

layouts/shortcodes/img.html

@@ -1,381 +0,0 @@
-{{- /*
-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" "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 "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. */}}
-{{- if $example }}
-  <p>Original</p>
-  <img class='di ba b--black-20' style="width: initial;" src="{{ $i.RelPermalink }}" alt="{{ $alt }}">
-  <p>Processed</p>
-  <img class='di ba b--black-20' style="width: initial;" src="{{ $fi.RelPermalink }}" alt="{{ $alt }}">
-{{- else -}}
-  <img class='di' style="width: initial;" src="{{ $fi.RelPermalink }}" alt="{{ $alt }}">
-{{- end }}
-
-{{- define "validate-arg-count" }}
-  {{- $msg := "When using the %q filter, the %q shortcode requires an args parameter with %d %s. See %s" }}
-  {{- if lt (len .args) .argsRequired }}
-    {{- $text := "values" }}
-    {{- if eq 1 .argsRequired }}
-      {{- $text = "value" }}
-    {{- end }}
-    {{- errorf $msg .filter .name .argsRequired $text .position }}
-  {{- end }}
-{{- end }}
-
-{{- define "validate-arg-value" }}
-  {{- $msg := "The %q argument passed to the %q shortcode is invalid. Expected a value in the range [%v,%v], but received %v. See %s" }}
-  {{- if or (lt .argValue .min) (gt .argValue .max) }}
-    {{- errorf $msg .argName .name .min .max .argValue .position }}
-  {{- end }}
-{{- end }}
-
-{{- define "partials/inline/get-resource.html" }}
-  {{- $r := "" }}
-  {{- $u := urls.Parse .src }}
-  {{- $msg := "The %q shortcode was unable to resolve %s. See %s" }}
-  {{- if $u.IsAbs }}
-    {{- with resources.GetRemote $u.String }}
-      {{- with .Err }}
-        {{- errorf "%s" }}
-      {{- else }}
-        {{- /* This is a remote resource. */}}
-        {{- $r = . }}
-      {{- end }}
-    {{- else }}
-      {{- errorf $msg $.name $u.String $.position }}
-    {{- end }}
-  {{- else }}
-    {{- with .page.Resources.Get (strings.TrimPrefix "./" $u.Path) }}
-      {{- /* This is a page resource. */}}
-      {{- $r = . }}
-    {{- else }}
-      {{- with resources.Get $u.Path }}
-        {{- /* This is a global resource. */}}
-        {{- $r = . }}
-      {{- else }}
-        {{- errorf $msg $.name $u.Path $.position }}
-      {{- end }}
-    {{- end }}
-  {{- end }}
-  {{- return $r}}
-{{- end -}}

layouts/shortcodes/new-in.html

@@ -1,36 +0,0 @@
-{{- /*
-Renders a "new in" button indicating the version in which a feature was added.
-
-When comparing the current version to the specified version, the "new in"
-button will be hidden if any of the following conditions is true:
-
-- The major version difference exceeds the majorVersionDiffThreshold
-- The minor version difference exceeds the minorVersionDiffThreshold
-
-@param {string} version The semantic version string, with or without a leading v.
-@returns {template.HTML}
-
-@example {{< new-in 0.100.0 >}}
-*/}}
-
-{{- /* Set defaults. */}}
-{{- $majorVersionDiffThreshold := 0 }}
-{{- $minorVersionDiffThreshold := 30 }}
-{{- $displayExpirationWarning := true }}
-
-{{- /* Render. */}}
-{{- with $version := .Get 0 | strings.TrimPrefix "v" }}
-  {{- $majorVersionDiff := sub (index (split hugo.Version ".") 0 | int) (index (split $version ".") 0 | int) }}
-  {{- $minorVersionDiff := sub (index (split hugo.Version ".") 1 | int) (index (split $version ".") 1 | int) }}
-  {{- if or (gt $majorVersionDiff $majorVersionDiffThreshold) (gt $minorVersionDiff $minorVersionDiffThreshold) }}
-    {{- if $displayExpirationWarning }}
-      {{- warnf "This call to the %q shortcode should be removed: %s. The button is now hidden because the specified version (%s) is older than the display threshold." $.Name $.Position $version }}
-    {{- end }}
-  {{- else }}
-    <button class="bg-white hover:bg-gray-100 text-gray-800 font-semibold py-2 mr2 mt2 px-4 border border-gray-400 rounded shadow">
-      <a href="{{ printf "https://github.com/gohugoio/hugo/releases/tag/v%s" $version }}">New in v{{ $version }}</a>
-    </button>
-  {{- end }}
-{{- else }}
-  {{- errorf "The %q shortcode requires a positional parameter (version). See %s" .Name .Position }}
-{{- end -}}