Added handlers for resolving image roots

Author: downpatch

Components/Pages/GuidePage.razor

@@ -40,20 +40,35 @@
     }
 
     @{
-        var ogImage = !string.IsNullOrWhiteSpace(_ogImage)
-        ? _ogImage
-        : Brand.DefaultOgImage;
+        var ogImage = !string.IsNullOrWhiteSpace(_ogImage) ? _ogImage : Brand.DefaultOgImage;
+        var squareImage = !string.IsNullOrWhiteSpace(_squareImage) ? _squareImage : "";
     }
+
     @if (!string.IsNullOrWhiteSpace(ogImage))
     {
         <meta property="og:image" content="@ToAbsolute(ogImage)" />
         <meta name="twitter:card" content="summary_large_image" />
     }
-    else
+
+    @if (!string.IsNullOrWhiteSpace(squareImage))
     {
-        <meta name="twitter:card" content="summary" />
+        <meta property="og:image" content="@ToAbsolute(squareImage)" />
+        <meta property="og:image:width" content="1024" />
+        <meta property="og:image:height" content="1024" />
+
+
+        <link rel="icon"
+              type="image/webp"
+              href="@ToAbsolute(_squareImage)" />
+
+        <link rel="apple-touch-icon"
+              href="@ToAbsolute(_squareImage)" />
+
+        <meta name="msapplication-TileImage"
+              content="@ToAbsolute(_squareImage)" />
     }
 
+
     <meta name="twitter:title" content="@_pageTitleFull" />
     @if (!string.IsNullOrWhiteSpace(_description))
     {
@@ -161,6 +176,8 @@ else
     private string _title = "Loading...";
     private string? _description;
     private string? _ogImage;
+    private string? _squareImage;
+
     private string? _canonical;
     private bool _noIndex;
 
@@ -234,6 +251,8 @@ protected override async Task OnParametersSetAsync()
         _title = "Not found";
         _description = null;
         _ogImage = null;
+        _squareImage = doc.SquareImage;
+
         _noIndex = true;
         _canonical = BuildCanonical(ctx, slug ?? "");
         return;
@@ -243,6 +262,8 @@ protected override async Task OnParametersSetAsync()
     _title = doc.Title;
     _description = doc.Description;
     _ogImage = doc.OgImage;
+    _squareImage = doc.SquareImage;
+
     _noIndex = doc.NoIndex;
     _canonical = BuildCanonical(ctx, doc.Slug, doc.Canonical);
 

Data/MarkdownDoc.cs

@@ -17,6 +17,7 @@ public sealed class MarkdownDoc
         public string? Canonical { get; init; }
         public bool NoIndex { get; init; }
         public string? OgImage { get; init; }
+        public string? SquareImage { get; init; }
 
         public required string Html { get; init; }
         public required DateTime LastModifiedUtc { get; init; }

Services/MarkdownStore.cs

@@ -126,7 +126,6 @@ private bool HasIndex(string slug)
             var description = fm.GetString("description");
             var canonical = fm.GetString("canonical");
             var noindex = fm.GetBool("noindex", defaultValue: false);
-            var ogImage = fm.GetString("og_image") ?? fm.GetString("og:image");
             var gameName = fm.GetString("game") ?? title;
             var leaderboardUrl = fm.GetString("leaderboard");
             var timingMethod = fm.GetString("timing_method"); // e.g. "RTA (AutoSplitter + LRT)" etc
@@ -135,6 +134,13 @@ private bool HasIndex(string slug)
             var whereToBuy = fm.GetString("where_to_buy");
             var platforms = fm.GetList("platforms");
 
+
+            var ogImageRaw = fm.GetString("og_image") ?? fm.GetString("og:image");
+            var squareImageRaw = fm.GetString("square_image") ?? fm.GetString("square:image");
+
+            var ogImage = ResolveAssetPath(ogImageRaw, slug);
+            var squareImage = ResolveAssetPath(squareImageRaw, slug);
+
             var etag = ComputeETag(fi.Length, lastWrite);
 
             var doc = new MarkdownDoc
@@ -156,7 +162,8 @@ private bool HasIndex(string slug)
                 Html = body,
                 LastModifiedUtc = lastWrite,
                 ETag = etag,
-                OgImage = ogImage
+                OgImage = ogImage,
+                SquareImage = squareImage
             };
 
             Console.WriteLine($"slug={slug} path={path} exists={File.Exists(path)}");
@@ -340,6 +347,32 @@ public Task<List<DocEntry>> GetGuideIndexAsync(string host, CancellationToken ct
 
             return Task.FromResult(items);
         }
+        private static string? ResolveAssetPath(string? raw, string slug)
+        {
+            if (string.IsNullOrWhiteSpace(raw)) return null;
+
+            raw = raw.Trim();
+
+            // Already absolute URL
+            if (raw.StartsWith("http://", StringComparison.OrdinalIgnoreCase) ||
+                raw.StartsWith("https://", StringComparison.OrdinalIgnoreCase))
+                return raw;
+
+            // Already absolute path (site-root)
+            if (raw.StartsWith("/"))
+                return raw;
+
+            // Relative to the doc folder
+            // slug is like "guide/template-game" or "guide/template-game/index"
+            var cleanSlug = (slug ?? "").Trim('/');
+
+            if (cleanSlug.EndsWith("/index", StringComparison.OrdinalIgnoreCase))
+                cleanSlug = cleanSlug[..^"/index".Length].TrimEnd('/');
+
+            // folder base under content
+            // -> /content/guide/template-game/ + raw
+            return $"/content/{cleanSlug}/{raw}".Replace("\\", "/");
+        }
 
 
         private sealed record CacheEntry(DateTime LastWriteUtc, MarkdownDoc Doc);