Add support for llms.txt

Author: mythz

MyApp/Configure.Ssg.cs

@@ -52,6 +52,7 @@ public void Configure(IWebHostBuilder builder) => builder
                 pages.LoadFrom("_pages");
                 videos.LoadFrom("_videos");
                 AppConfig.Instance.GitPagesBaseUrl ??= ResolveGitBlobBaseUrl(appHost.ContentRootDirectory);
+                AppConfig.Instance.GitPagesRawBaseUrl ??= ResolveGitRawBlobBaseUrl(appHost.ContentRootDirectory);
             },
             afterAppHostInit: appHost =>
             {
@@ -95,14 +96,34 @@ public void Configure(IWebHostBuilder builder) => builder
         }
         return null;
     }
+    
+    private string? ResolveGitRawBlobBaseUrl(IVirtualDirectory contentDir)
+    {
+        var srcDir = new DirectoryInfo(contentDir.RealPath);
+        var gitConfig = new FileInfo(Path.Combine(srcDir.Parent!.FullName, ".git", "config"));
+        if (gitConfig.Exists)
+        {
+            var txt = gitConfig.ReadAllText();
+            var pos = txt.IndexOf("url = ", StringComparison.Ordinal);
+            if (pos >= 0)
+            {
+                var url = txt[(pos + "url = ".Length)..].LeftPart(".git").LeftPart('\n').Trim();
+                var gitBaseUrl = url.Replace("github.com","raw.githubusercontent.com").CombineWith($"refs/heads/main/{srcDir.Name}");
+                return gitBaseUrl;
+            }
+        }
+        return null;
+    }
 }
 
 public class AppConfig
 {
     public static AppConfig Instance { get; } = new();
+    public string Title { get; set; }
     public string LocalBaseUrl { get; set; }
     public string PublicBaseUrl { get; set; }
     public string? GitPagesBaseUrl { get; set; }
+    public string? GitPagesRawBaseUrl { get; set; }
 }
 
 // Add additional frontmatter info to include

MyApp/Pages/Llms.cshtml

@@ -0,0 +1,27 @@
+@page "/llms.txt"
+@inject MarkdownPages Markdown
+@inject AppConfig Config
+@attribute [RenderStatic]
+@{
+    Layout = "";
+    Response.ContentType = "text/plain";
+}
+# @Config.Title
+
+## Docs
+@foreach (var entry in Markdown.Sidebars.OrderBy(x => x.Key))
+{
+    @foreach (var sidebar in entry.Value)
+    {
+<text>
+@(sidebar.Text)
+</text>
+        foreach (var item in sidebar.Children.Safe().Where(x => x.Text != null && x.Link != null))
+        {
+            var page = Markdown!.GetBySlug(item.Link);
+            var suffix = !string.IsNullOrEmpty(page?.Title) && item.Text != page.Title ? $": {page.Title}" : "";
+<text> - [@item.Text](@(@Config.GitPagesRawBaseUrl.CombineWith($"_pages/").CombineWith(item.Link.LeftPart('#') + ".md")))@Html.Raw(suffix)
+</text>
+        }
+    }
+}

MyApp/appsettings.json

@@ -7,6 +7,7 @@
   },
   "AllowedHosts": "*",
   "AppConfig": {
+    "Title": "ServiceStack",
     "LocalBaseUrl": "https://localhost:5002",
     "PublicBaseUrl": "https://docs.servicestack.net"
   }