Self-host sample source code pages

samples/build-tools/build-scripts/BuildAppSettings.cs

@@ -8,7 +8,6 @@
 //   -k, --api-key <key>        ArcGIS API key (required)
 //   -l, --license-key <key>    GeoBlazor license key (required)
 //   -o, --output <path>        Output path(s) for appsettings.json (required, can specify multiple)
-//   -d, --docs-url <url>       Documentation URL (default: https://docs.geoblazor.com)
 //   -b, --bypass-key <key>     API bypass key for samples (optional)
 //   -w, --wfs-servers <json>   Additional WFS server configuration JSON fragment (optional)
 //   -h, --help                 Display help message
@@ -22,7 +21,6 @@
 string? arcGISApiKey = null;
 string? licenseKey = null;
 List<string> outputPaths = [];
-string docsUrl = "https://docs.geoblazor.com";
 string byPassApiKey = "";
 string wfsServers = "";
 bool help = false;
@@ -54,13 +52,6 @@
                 outputPaths.Add(args[++i]);
             }
             break;
-        case "-d":
-        case "--docs-url":
-            if (i + 1 < args.Length)
-            {
-                docsUrl = args[++i];
-            }
-            break;
         case "-b":
         case "--bypass-key":
             if (i + 1 < args.Length)
@@ -93,7 +84,6 @@
     Console.WriteLine("  -k, --api-key <key>        ArcGIS API key (required)");
     Console.WriteLine("  -l, --license-key <key>    GeoBlazor license key (required)");
     Console.WriteLine("  -o, --output <path>        Output path(s) for appsettings.json (required, can specify multiple)");
-    Console.WriteLine("  -d, --docs-url <url>       Documentation URL (default: https://docs.geoblazor.com)");
     Console.WriteLine("  -b, --bypass-key <key>     API bypass key for samples (optional)");
     Console.WriteLine("  -w, --wfs-servers <json>   Additional WFS server configuration JSON fragment (optional)");
     Console.WriteLine("  -h, --help                 Display this help message");
@@ -130,7 +120,6 @@
 sb.AppendLine("  \"GeoBlazor\": {");
 sb.AppendLine($"    \"LicenseKey\": \"{EscapeJsonString(licenseKey)}\"");
 sb.AppendLine("  },");
-sb.AppendLine($"  \"DocsUrl\": \"{EscapeJsonString(docsUrl)}\",");
 sb.Append($"  \"ByPassApiKey\": \"{EscapeJsonString(byPassApiKey)}\"");
 
 // Add WFS servers if provided

samples/core/dymaptic.GeoBlazor.Core.Sample.Maui/MauiProgram.cs

@@ -38,6 +38,7 @@ public static MauiApp CreateMauiApp()
         builder.Configuration.AddConfiguration(config);
         builder.Services.AddGeoBlazor(builder.Configuration);
         builder.Services.AddScoped<LayoutService>();
+        builder.Services.AddSingleton<ISampleSourceProvider, SampleSourceProvider>();
 
         return builder.Build();
     }

samples/pro/dymaptic.GeoBlazor.Pro.Sample.Shared/Pages/SourceCode.razor → samples/core/dymaptic.GeoBlazor.Core.Sample.Shared/Pages/SourceCode.razor

@@ -1,10 +1,14 @@
-@page "/source-code"
+@page "/source-code"
 @page "/source-code/{PageUrl}"
 
 <PageTitle>Source Code</PageTitle>
 <h1>Source Code</h1>
 
-@if (string.IsNullOrWhiteSpace(_razorContent))
+@if (_notFound)
+{
+    <p>Source for <code>@PageUrl</code> is not embedded in the sample app.</p>
+}
+else if (string.IsNullOrWhiteSpace(_razorContent))
 {
     <p>Loading...</p>
 }
@@ -15,4 +19,4 @@ else
     {
         <CodeHighlight Language="csharp" Code="@_codeContent" />
     }
-}
+}

samples/core/dymaptic.GeoBlazor.Core.Sample.Shared/Pages/SourceCode.razor.cs

@@ -0,0 +1,109 @@
+using System.Reflection;
+using dymaptic.GeoBlazor.Core.Sample.Shared.Shared;
+using Microsoft.AspNetCore.Components;
+
+namespace dymaptic.GeoBlazor.Core.Sample.Shared.Pages;
+
+public partial class SourceCode
+{
+    [Parameter]
+    public string? PageUrl { get; set; }
+
+    [Inject]
+    public required ISampleSourceProvider SourceProvider { get; set; }
+
+    protected override void OnParametersSet()
+    {
+        if (string.IsNullOrWhiteSpace(PageUrl))
+        {
+            _razorContent = string.Empty;
+            _codeContent = string.Empty;
+            _notFound = false;
+            return;
+        }
+
+        Type? pageType = ResolvePageType(PageUrl);
+        if (pageType is null)
+        {
+            _razorContent = string.Empty;
+            _codeContent = string.Empty;
+            _notFound = true;
+            return;
+        }
+
+        (string razor, string? codeBehind) = SourceProvider.GetSource(pageType);
+
+        if (string.IsNullOrEmpty(razor))
+        {
+            _razorContent = string.Empty;
+            _codeContent = string.Empty;
+            _notFound = true;
+            return;
+        }
+
+        _notFound = false;
+
+        // split apart the markup section and the code section so the highlighting can be language-specific
+        // for HTML and C#, since there is no widely accepted Razor syntax highlighting
+        if (razor.Contains("@code"))
+        {
+            int codeIndex = razor.IndexOf("@code", StringComparison.Ordinal);
+            _codeContent = razor[codeIndex..].Trim();
+            _razorContent = razor[..codeIndex].Trim();
+        }
+        else
+        {
+            _razorContent = razor;
+            _codeContent = string.Empty;
+        }
+
+        if (!string.IsNullOrEmpty(codeBehind))
+        {
+            _razorContent = $"""
+                             ## {PageUrl}.razor
+
+                             {_razorContent}
+                             """;
+            _codeContent = $"""
+                            ## {PageUrl}.razor.cs
+
+                            {codeBehind}
+                            """;
+        }
+    }
+
+    private static Type? ResolvePageType(string typeName)
+    {
+        Dictionary<string, Type> index = LazyPageIndex.Value;
+        return index.TryGetValue(typeName, out Type? t) ? t : null;
+    }
+
+    private static readonly Lazy<Dictionary<string, Type>> LazyPageIndex = new(() =>
+    {
+        var index = new Dictionary<string, Type>(StringComparer.Ordinal);
+        foreach (Assembly assembly in AppDomain.CurrentDomain.GetAssemblies())
+        {
+            string? name = assembly.GetName().Name;
+            if (name is null) continue;
+            if (!name.Contains("Sample.Shared", StringComparison.Ordinal)) continue;
+
+            Type[] types;
+            try { types = assembly.GetExportedTypes(); }
+            catch { continue; }
+
+            foreach (Type type in types)
+            {
+                if (type.GetCustomAttributes<RouteAttribute>().Any())
+                {
+                    // last writer wins; Pro can shadow Core if names collide
+                    index[type.Name] = type;
+                }
+            }
+        }
+        return index;
+    });
+
+    private string _razorContent = string.Empty;
+    private string _codeContent = string.Empty;
+    private bool _notFound;
+}

samples/core/dymaptic.GeoBlazor.Core.Sample.Shared/Shared/MainLayout.razor

@@ -72,7 +72,7 @@
     }
 
     protected virtual Type NavMenuType => typeof(NavMenu);
-    protected virtual Type? AdditionalLinksType => null;
+    protected virtual Type? AdditionalLinksType => typeof(SourceNav);
 
     private readonly string[] _btnTypes = ["btn-primary", "btn-secondary", "btn-accent"];
 

samples/core/dymaptic.GeoBlazor.Core.Sample.Shared/Shared/SampleSourceProvider.cs

@@ -0,0 +1,27 @@
+using System.Reflection;
+
+namespace dymaptic.GeoBlazor.Core.Sample.Shared.Shared;
+
+public interface ISampleSourceProvider
+{
+    (string Razor, string? CodeBehind) GetSource(Type pageType);
+}
+
+public class SampleSourceProvider : ISampleSourceProvider
+{
+    public (string Razor, string? CodeBehind) GetSource(Type pageType)
+    {
+        Assembly assembly = pageType.Assembly;
+        string razor = ReadResource(assembly, $"SampleSource/{pageType.Name}.razor") ?? string.Empty;
+        string? codeBehind = ReadResource(assembly, $"SampleSource/{pageType.Name}.razor.cs");
+        return (razor, codeBehind);
+    }
+
+    private static string? ReadResource(Assembly assembly, string logicalName)
+    {
+        using Stream? stream = assembly.GetManifestResourceStream(logicalName);
+        if (stream is null) return null;
+        using var reader = new StreamReader(stream);
+        return reader.ReadToEnd();
+    }
+}

samples/pro/dymaptic.GeoBlazor.Pro.Sample.Shared/Shared/SourceNav.razor → samples/core/dymaptic.GeoBlazor.Core.Sample.Shared/Shared/SourceNav.razor

@@ -7,10 +7,10 @@
 <a class="btn btn-secondary" @onclick="ViewRepositorySource">GitHub<br/>Repo</a>
 
 @code {
-    
+
     [Inject]
     public required NavigationManager NavigationManager { get; set; }
-    
+
     [CascadingParameter(Name="PageRouteData")]
     public required RouteData RouteData { get; set; }
 
@@ -25,4 +25,4 @@
         NavigationManager.NavigateTo("https://github.com/dymaptic/GeoBlazor");
     }
 
-}
+}

samples/core/dymaptic.GeoBlazor.Core.Sample.Shared/dymaptic.GeoBlazor.Core.Sample.Shared.csproj

@@ -42,4 +42,9 @@
     <ItemGroup>
       <AdditionalFiles Include="Shared\RenderModeSelector.razor" />
     </ItemGroup>
+
+    <ItemGroup>
+      <EmbeddedResource Include="Pages\**\*.razor" LogicalName="SampleSource/%(Filename)%(Extension)" />
+      <EmbeddedResource Include="Pages\**\*.razor.cs" LogicalName="SampleSource/%(Filename)%(Extension)" />
+    </ItemGroup>
 </Project>

samples/core/dymaptic.GeoBlazor.Core.Sample.Wasm/Program.cs

@@ -11,6 +11,7 @@
 
 builder.Services.AddGeoBlazor(builder.Configuration);
 builder.Services.AddScoped<LayoutService>();
+builder.Services.AddSingleton<ISampleSourceProvider, SampleSourceProvider>();
 builder.Configuration.AddInMemoryCollection();
 builder.Services.AddScoped<HttpClient>();
 

samples/core/dymaptic.GeoBlazor.Core.Sample.WebApp/dymaptic.GeoBlazor.Core.Sample.WebApp.Client/Program.cs

@@ -9,5 +9,6 @@
 builder.Services.AddGeoBlazor(builder.Configuration);
 builder.Services.AddSingleton<IConfiguration>(_ => builder.Configuration);
 builder.Services.AddScoped<LayoutService>();
+builder.Services.AddSingleton<ISampleSourceProvider, SampleSourceProvider>();
 
 await builder.Build().RunAsync();

samples/core/dymaptic.GeoBlazor.Core.Sample.WebApp/dymaptic.GeoBlazor.Core.Sample.WebApp/Program.cs

@@ -14,6 +14,7 @@
 builder.Services.AddGeoBlazor(builder.Configuration);
 builder.Services.AddScoped<HttpClient>();
 builder.Services.AddScoped<LayoutService>();
+builder.Services.AddSingleton<ISampleSourceProvider, SampleSourceProvider>();
 builder.Configuration.AddInMemoryCollection();
 
 WebApplication app = builder.Build();

samples/pro/dymaptic.GeoBlazor.Pro.Sample.Maui/MauiProgram.cs

@@ -38,6 +38,7 @@ public static MauiApp CreateMauiApp()
         builder.Configuration.AddConfiguration(config);
         builder.Services.AddGeoBlazorPro(builder.Configuration);
         builder.Services.AddScoped<LayoutService>();
+        builder.Services.AddSingleton<ISampleSourceProvider, SampleSourceProvider>();
 
         return builder.Build();
     }

samples/pro/dymaptic.GeoBlazor.Pro.Sample.Shared/dymaptic.GeoBlazor.Pro.Sample.Shared.csproj

@@ -38,4 +38,9 @@
     <Target Name="Copy Razor Files" BeforeTargets="Build" Condition="'$(UseProjectReferences)' == 'true'">
         <Exec Command="dotnet $(ProGBBuildToolsPath)/RazorCopy.dll"/>
     </Target>
+
+    <ItemGroup>
+      <EmbeddedResource Include="Pages\**\*.razor" LogicalName="SampleSource/%(Filename)%(Extension)" />
+      <EmbeddedResource Include="Pages\**\*.razor.cs" LogicalName="SampleSource/%(Filename)%(Extension)" />
+    </ItemGroup>
 </Project>

samples/pro/dymaptic.GeoBlazor.Pro.Sample.Wasm/Program.cs

@@ -14,5 +14,6 @@
 
 builder.Services.AddGeoBlazorPro(builder.Configuration);
 builder.Services.AddScoped<LayoutService>();
+builder.Services.AddSingleton<ISampleSourceProvider, SampleSourceProvider>();
 
 await builder.Build().RunAsync();

samples/pro/dymaptic.GeoBlazor.Pro.Sample.WebApp/dymaptic.GeoBlazor.Pro.Sample.WebApp.Client/Program.cs

@@ -8,6 +8,7 @@
 builder.Services.AddScoped<HttpClient>();
 builder.Services.AddGeoBlazorPro(builder.Configuration);
 builder.Services.AddScoped<LayoutService>();
+builder.Services.AddSingleton<ISampleSourceProvider, SampleSourceProvider>();
 builder.Services.AddSingleton<IConfiguration>(_ => builder.Configuration);
 
 await builder.Build().RunAsync();