feat(helper/image): new image helper (WIP)

layouts/partials/article-list/compact.html

@@ -12,13 +12,17 @@
         </footer>
     </div>
 
-    {{ if .Params.image }}
-    {{- $image := partial "helper/image" . -}}
-    {{- $thumbnail := $image.Fill "120x120" -}}
+    {{ $image := partial "helper/image" . }}
     
+    {{ if $image.exists }}
         <div class="article-image">
+            {{ if $image.local }}
+                {{- $thumbnail := $image.src.Fill "120x120" -}}
                 <img src="{{ $thumbnail.RelPermalink }}" width="{{ $thumbnail.Width }}"
                     height="{{ $thumbnail.Height }}" loading="lazy">
+            {{ else }}
+                <img src="{{ $image.src }}" loading="lazy" alt="Featured image of post {{ .Title }}" />
+            {{ end }}
         </div>
     {{ end }}
 </article>

layouts/partials/article-list/default.html

@@ -1,15 +1,20 @@
 <article class="{{ if .Params.image }}has-image{{ end }}">
-    {{ if .Params.image }}
-        {{- $image := partial "helper/image" . -}}
-        {{- $thumbnail := $image.Fill "800x250" -}}
-        {{- $thumbnailRetina := $image.Fill "1600x500" -}}
+    {{ $image := partial "helper/image" . }}
 
+    {{ if $image.exists }}
         <div class="article-image">
             <a href="{{ .Permalink }}">
+                {{ if $image.local }}
+                    {{- $thumbnail := $image.src.Fill "800x250" -}}
+                    {{- $thumbnailRetina := $image.src.Fill "1600x500" -}}
+
                     <img src="{{ $thumbnail.RelPermalink }}" 
                         srcset="{{ $thumbnail.RelPermalink }} 1x, {{ $thumbnailRetina.RelPermalink }} 2x"
                         width="{{ $thumbnail.Width }}" height="{{ $thumbnail.Height }}" loading="lazy"
                         alt="Featured image of post {{ .Title }}" />
+                {{ else }}
+                    <img src="{{ $image.src }}" loading="lazy" alt="Featured image of post {{ .Title }}" />
+                {{ end }}
             </a>
         </div>
     {{ end }}

layouts/partials/article-list/tile.html

@@ -1,11 +1,18 @@
-<article class="{{ if .context.Params.image }}has-image{{ end }}">
+{{ $image := partial "helper/image" .context }}
+<article class="{{ if $image.exists }}has-image{{ end }}">
     <a href="{{ .context.Permalink }}">
-        {{ if .context.Params.image }}
-        {{- $image := partial "helper/image" .context | resources.Fingerprint "md5"  -}}
-        {{- $thumbnail :=  $image.Fill .size -}}
+        
+        {{ if $image.exists }}
             <div class="article-image">
+                {{ if $image.local }}
+                    {{- $imageRaw := $image.src | resources.Fingerprint "md5" -}}
+                    {{- $thumbnail := $imageRaw.Fill .size -}}
+
                     <img src="{{ $thumbnail.RelPermalink }}" width="{{ $thumbnail.Width }}" height="{{ $thumbnail.Height }}" 
-                loading="lazy" data-key="{{ .context.Slug }}" data-hash="{{ $image.Data.Integrity }}">
+                        loading="lazy" data-key="{{ .context.Slug }}" data-hash="{{ $imageRaw.Data.Integrity }}">
+                {{ else }}
+                    <img src="{{ $image.src }}" loading="lazy" data-key="{{ .context.Slug }}" data-hash="{{ $image.src }}"/>
+                {{ end }}
             </div>
         {{ end }}
 

layouts/partials/article/components/details.html

@@ -1,15 +1,14 @@
-{{ $i := .Params.image }}
+{{ $image := partial "helper/image" . }}
 {{ $context := . }}
-
 <div class="article-details">
     {{ with $categories := .Params.categories }}
     <header class="article-category">
         {{ range $categories }}
-            {{ if $i }}
-                {{- $image := partial "helper/image" $context | resources.Fingerprint "md5"  -}}
-                {{- $20x := $image.Fill "20x20 smart"  -}}
+            {{ if and $image.exists $image.local }}
+                {{- $imageRaw := $image.src | resources.Fingerprint "md5"  -}}
+                {{- $20x := $imageRaw.Fill "20x20 smart"  -}}
                 <a href="/categories/{{ . | urlize }}" class="color-tag"
-                    data-image="{{ $20x.RelPermalink }}" data-key="{{ $context.Slug }}" data-hash="{{ $image.Data.Integrity }}">{{ . | humanize }}</a>
+                    data-image="{{ $20x.RelPermalink }}" data-key="{{ $context.Slug }}" data-hash="{{ $imageRaw.Data.Integrity }}">{{ . | humanize }}</a>
             {{ else }}
                 <a href="/categories/{{ . | urlize }}">{{ . | humanize }}</a>
             {{ end }}

layouts/partials/article/components/header.html

@@ -1,15 +1,18 @@
 <header class="article-header">
-    {{ if .Params.image }}
-    {{- $image := partial "helper/image" . -}}
-
-    {{- $tablet := $image.Resize "1024x" -}}
-    {{- $desktop := $image.Resize "2000x" -}}
+    {{ $image := partial "helper/image" . }}
 
+    {{ if $image.exists }}
         <div class="article-image">
+            {{ if $image.local }}
+                {{- $tablet := $image.src.Resize "1024x" -}}
+                {{- $desktop := $image.src.Resize "2000x" -}}
+
                 <img srcset="{{ $tablet.RelPermalink }} 1024w, {{ $desktop.RelPermalink }} 2000w"
-            src="{{ $desktop.RelPermalink }}" width="{{ $image.Width }}" height="{{ $image.Height }}"
-            loading="lazy"
+                    src="{{ $desktop.RelPermalink }}" width="{{ $image.Width }}" height="{{ $image.Height }}" loading="lazy"
                     alt="Featured image of post {{ .Title }}" />
+            {{ else }}
+                <img src="{{ $image.src }}" loading="lazy" alt="Featured image of post {{ .Title }}" />
+            {{ end }}
         </div>
     {{ end }}
 

layouts/partials/head/opengraph.html

@@ -40,11 +40,15 @@
 	{{- end -}}
 {{- end -}}
 
-{{- if .Params.image -}}
-	{{ $image := partial "helper/image" . }}
+{{ $image := partial "helper/image" . }}
+{{- if $image.exists -}}
+	{{ $imagePermalink := $image.src }}
+	{{ if $image.local }}
+		{{ $imagePermalink = absURL $image.src.RelPermalink }}
+	{{ end }}
 	<meta name="twitter:card" content="summary_large_image">
-	<meta property='og:image' content='{{ absURL $image.RelPermalink }}' />
-	<meta name="twitter:image" content='{{ absURL $image.RelPermalink }}' />
+	<meta property='og:image' content='{{ $imagePermalink }}' />
+	<meta name="twitter:image" content='{{ $imagePermalink }}' />
 {{- else if .Site.Params.opengraph.defaultImage -}}
 	{{ $image := resources.Get .Site.Params.opengraph.defaultImage }}
 	<meta property='og:image' content='{{ absURL $image.RelPermalink }}' />

layouts/partials/helper/image.html

@@ -1,2 +1,31 @@
-{{- $image := .Resources.GetMatch (printf "%s" (.Params.image | safeURL)) -}}
-{{ return $image }}
+{{ $result := dict "exists" false "local" false "isDefault" false }}
+{{ $imageField := .Params.image }}
+{{ if $imageField }}
+    <!-- If page has `image` field set -->
+    {{ $result = merge $result (dict "exists" true) }}
+
+    {{ if strings.HasPrefix $imageField "http" }}
+        <!-- Is a external image -->
+        {{ $result = merge $result (dict "src" $imageField) }}
+    {{ else }}
+        {{ $pageResourceImage := .Resources.GetMatch (printf "%s" ($imageField | safeURL)) }}
+        {{ $siteResourceImage := resources.GetMatch (printf "%s" ($imageField | safeURL)) }}
+        
+        {{ if $pageResourceImage }}
+            <!-- If image is found under page bundle -->
+            {{ $result = merge $result (dict "local" true) }}
+            {{ $result = merge $result (dict "src" $pageResourceImage) }}
+        {{ else if $siteResourceImage }}
+            <!-- Try search image under site's assets folder -->
+            {{ $result = merge $result (dict "local" true) }}
+            {{ $result = merge $result (dict "src" $siteResourceImage) }}
+        {{ else }}
+            <!-- Can not find the image -->
+            {{ errorf "Failed loading image: %q" $imageField }}
+            {{ $result = merge $result (dict "exists" false) }}
+        {{ end }}
+    {{ end }}
+
+{{ end }}
+
+{{ return $result }}