diff --git a/config/_default/markup.toml b/config/_default/markup.toml index fccbfcc2..1cd9c5bc 100644 --- a/config/_default/markup.toml +++ b/config/_default/markup.toml @@ -2,6 +2,9 @@ # These settings are required for the theme to function. [goldmark] + [goldmark.parser] + wrapStandAloneImageWithinParagraph = false + [goldmark.renderer] unsafe = true diff --git a/exampleSite/config/_default/markup.toml b/exampleSite/config/_default/markup.toml index fccbfcc2..1cd9c5bc 100644 --- a/exampleSite/config/_default/markup.toml +++ b/exampleSite/config/_default/markup.toml @@ -2,6 +2,9 @@ # These settings are required for the theme to function. [goldmark] + [goldmark.parser] + wrapStandAloneImageWithinParagraph = false + [goldmark.renderer] unsafe = true diff --git a/layouts/_default/_markup/render-image.html b/layouts/_default/_markup/render-image.html index 60a92d6d..4f13a430 100644 --- a/layouts/_default/_markup/render-image.html +++ b/layouts/_default/_markup/render-image.html @@ -1,56 +1,109 @@ -{{ define "RenderImageSimple" -}} - {{ .alt }} -{{- end }} - -{{ define "RenderImageResponsive" -}} +{{- define "RenderImageSimple" -}} + {{- $imgObj := .imgObj -}} + {{- $src := .src -}} + {{- $alt := .alt -}} {{ .alt }} -{{- end }} + alt="{{ $alt }}" + src="{{ $src }}" + {{ with $imgObj -}} + {{ with $imgObj.Width }}width="{{ . }}"{{ end }} + {{ with $imgObj.Height }}height="{{ . }}"{{ end }} + {{- end }}> +{{- end -}} -{{ define "RenderImageCaption" -}} - {{- with .caption }} +{{- define "RenderImageResponsive" -}} + {{/* Responsive Image + The current setting sizes="(min-width: 768px) 50vw, 65vw" makes the iPhone 16 and 16 Pro + select a smaller image, while the iPhone 16 Pro Max selects a larger image. + + Steps: + 1. Check the media queries in the `sizes` property. + 2. Find the first matching value. For example, on a mobile device with a CSS pixel width + of 390px and DPR = 3 (iPhone 13), given setting sizes="(min-width: 768px) 50vw, 100vw", + it matches the `100vw` option. + 3. Calculate the optimal image size: 390 × 3 × 100% (100vw) = 1170. + 4. Find the corresponding match in the `srcset`. + + To make the browser select a smaller image on mobile devices + override the template and change the `sizes` property to "(min-width: 768px) 50vw, 30vw" + + The sizes="auto" is valid only when loading="lazy". + */}} + {{- $imgObj := .imgObj -}} + {{- $alt := .alt -}} + {{- $originalWidth := $imgObj.Width -}} + + {{- $img800 := $imgObj -}} + {{- $img1280 := $imgObj -}} + {{- if gt $originalWidth 800 -}} + {{- $img800 = $imgObj.Resize "800x" -}} + {{- end -}} + {{- if gt $originalWidth 1280 -}} + {{- $img1280 = $imgObj.Resize "1280x" -}} + {{- end -}} + + {{- $srcset := printf "%s 800w, %s 1280w" $img800.RelPermalink $img1280.RelPermalink -}} + + + {{ $alt }} +{{- end -}} + +{{- define "RenderImageCaption" -}} + {{- with .caption -}}
{{ . | markdownify }}
- {{- end }} -{{- end }} + {{- end -}} +{{- end -}} -{{- $disableImageOptimizationMD := .Page.Site.Params.disableImageOptimizationMD | default false }} +{{- $disableImageOptimizationMD := .Page.Site.Params.disableImageOptimizationMD | default false -}} {{- $urlStr := .Destination | safeURL -}} {{- $url := urls.Parse $urlStr -}} -{{- $altText := .Text }} -{{- $caption := .Title }} -{{- $isRemote := findRE "^(https?|data)" $url.Scheme }} -{{- $resource := "" }} +{{- $altText := .Text -}} +{{- $caption := .Title -}} +{{- $isRemote := findRE "^(https?|data)" $url.Scheme -}} +{{- $resource := "" -}} -{{- if not $isRemote }} - {{- $resource = or ($.Page.Resources.GetMatch $urlStr) (resources.Get $urlStr) }} -{{- end }} +{{- if not $isRemote -}} + {{- $resource = or ($.Page.Resources.GetMatch $urlStr) (resources.Get $urlStr) -}} +{{- end -}}
- {{- if $isRemote }} - {{ template "RenderImageSimple" (dict "src" $urlStr "alt" $altText) }} - {{- else if $resource }} - {{- $isSVG := eq $resource.MediaType.SubType "svg" }} - {{- $shouldOptimize := and (not $disableImageOptimizationMD) (not $isSVG) }} - {{- if $shouldOptimize }} - {{ template "RenderImageResponsive" (dict "resource" $resource "alt" $altText) }} - {{- else }} - {{ template "RenderImageSimple" (dict "src" $resource.RelPermalink "alt" $altText) }} - {{- end }} - {{- else }} - {{ template "RenderImageSimple" (dict "src" $urlStr "alt" $altText) }} - {{- end }} + {{- if $isRemote -}} + {{- template "RenderImageSimple" (dict "imgObj" "" "src" $urlStr "alt" $altText) -}} + {{- else if $resource -}} + {{- $isSVG := eq $resource.MediaType.SubType "svg" -}} + {{- $shouldOptimize := and (not $disableImageOptimizationMD) (not $isSVG) -}} + {{- if $shouldOptimize -}} + {{- template "RenderImageResponsive" (dict "imgObj" $resource "alt" $altText) -}} + {{- else -}} + {{/* Not optimize image + If it is an SVG file, pass the permalink + Otherwise, pass the resource to allow width and height attributes + */}} + {{- if $isSVG -}} + {{- template "RenderImageSimple" (dict "imgObj" "" "src" $resource.RelPermalink "alt" $altText) -}} + {{- else -}} + {{- template "RenderImageSimple" (dict "imgObj" $resource "src" $resource.RelPermalink "alt" $altText) -}} + {{- end -}} + {{- end -}} + {{- else -}} + {{- template "RenderImageSimple" (dict "imgObj" "" "src" $urlStr "alt" $altText) -}} + {{- end -}} - {{ template "RenderImageCaption" (dict "caption" $caption) }} + {{- template "RenderImageCaption" (dict "caption" $caption) -}}
diff --git a/layouts/shortcodes/figure.html b/layouts/shortcodes/figure.html index 35f5e331..f1e9454d 100644 --- a/layouts/shortcodes/figure.html +++ b/layouts/shortcodes/figure.html @@ -31,14 +31,18 @@ {{- else }} {{ $altText }} {{- end }} {{- else }}