feat(theme): wrap standalone images in figure tags

assets/static/css/bcarlin.css

@@ -351,6 +351,12 @@ a[rel="external"]::after {
   text-decoration: none;
 }
 
+figure {
+  max-width: 50%;
+  text-align: center;
+  margin: var(--pico-block-spacing-vertical) auto;
+}
+
 /*
  * Admonitions
  */

config/_default/hugo.yaml

@@ -37,3 +37,6 @@ outputFormats:
 markup:
   highlight:
     noClasses: false
+  goldmark:
+    parser:
+      wrapStandAloneImageWithinParagraph: false

layouts/_markup/render-image.html

@@ -0,0 +1,45 @@
+{{- $u := urls.Parse .Destination -}}
+{{- $path := strings.TrimPrefix "./" $u.Path -}}
+{{- $res := or (.PageInner.Resources.Get $path) (resources.Get $path) -}}
+{{- $src := $u.String -}}
+{{- if not $u.IsAbs -}}
+  {{- with $res -}}
+    {{- $src = .RelPermalink -}}
+    {{- with $u.RawQuery -}}
+      {{- $src = printf "%s?%s" $src . -}}
+    {{- end -}}
+    {{- with $u.Fragment -}}
+      {{- $src = printf "%s#%s" $src . -}}
+    {{- end -}}
+  {{- end -}}
+{{- end -}}
+
+{{- if .IsBlock -}}
+<figure>
+  <img src="{{ $src }}" alt="{{ .PlainText }}"
+    {{- with .Title }} title="{{ . }}" {{- end -}}
+    {{- range $k, $v := .Attributes -}}
+      {{- if $v -}}
+        {{- printf " %s=%q" $k ($v | transform.HTMLEscape) | safeHTMLAttr -}}
+      {{- end -}}
+    {{- end -}}
+  >
+  {{- with $res.Params.legend -}}
+  <figcaption>
+    {{- . -}}
+  </figcaption>
+  {{- end -}}
+</figure>
+{{- else -}}
+  <img src="{{ $src }}" alt="{{ .PlainText }}"
+    {{- with .Title }} title="{{ . }}" {{- end -}}
+    {{- range $k, $v := .Attributes -}}
+      {{- if $v -}}
+        {{- printf " %s=%q" $k ($v | transform.HTMLEscape) | safeHTMLAttr -}}
+      {{- end -}}
+    {{- end -}}
+  >
+{{- end -}}
+
+{{- define "_partials/render-image.html" -}}
+{{- end -}}