Fixed some bugs with API doc generation & removed some classes from automatic API doc generation:

 - Added api doc generation multithreading
 - Improved xref url fixing
 - Docs are a little prettier

Author: space928

StarlightDocNet/MDStringBuilder.cs

@@ -7,18 +7,20 @@ namespace StarlightDocNet;
 public class MDStringBuilder
 {
     protected readonly StringBuilder sb = new();
-    public readonly string localURLRoot;
+    public readonly string localURLRoot = "/";
+    public readonly HashSet<string> knownPages = [];
 
     public readonly static MDStringBuilder Shared = new();
 
     public MDStringBuilder()
     {
-        localURLRoot = "/";
+
     }
 
-    public MDStringBuilder(string localURLRoot)
+    public MDStringBuilder(string localURLRoot, HashSet<string> knownPages)
     {
         this.localURLRoot = localURLRoot;
+        this.knownPages = knownPages;
     }
 
     public MDStringBuilder Clear()
@@ -40,6 +42,12 @@ public MDStringBuilder Add(char c)
         return this;
     }
 
+    public MDStringBuilder Add(ReadOnlySpan<char> c)
+    {
+        sb.Append(c);
+        return this;
+    }
+
     public MDStringBuilder Add(string? s)
     {
         if (s != null)
@@ -65,6 +73,18 @@ public MDStringBuilder Add(float x)
         return this;
     }
 
+    public MDStringBuilder Line()
+    {
+        sb.AppendLine();
+        return this;
+    }
+
+    public MDStringBuilder Line(ReadOnlySpan<char> s)
+    {
+        sb.Append(s).AppendLine();
+        return this;
+    }
+
     public MDStringBuilder Line(string s)
     {
         sb.AppendLine(s);
@@ -175,14 +195,16 @@ public MDStringBuilder Image(string img, string alt, string url)
         return this;
     }
 
-    public MDStringBuilder MetaHeader(string title, string? description = null, int? order = null)
+    public MDStringBuilder MetaHeader(string title, string? description = null, int? order = null, string? sidebarTitle = null)
     {
         sb.AppendLine("---");
         sb.Append("title: ").AppendLine(title);
         if (description != null)
             sb.Append("description: ").AppendLine(description);
         if (order != null)
             sb.Append("order: ").AppendLine(order.Value.ToString());
+        if (sidebarTitle != null)
+            sb.AppendLine("sidebar: ").Append("  label: ").AppendLine(sidebarTitle);
         sb.AppendLine("---").AppendLine();
         return this;
     }

StarlightDocNet/Program.cs

@@ -15,13 +15,26 @@ static void Main(string[] args)
         string dstPath = args[1];
 
         Stopwatch sw = Stopwatch.StartNew();
-        foreach (var path in Directory.EnumerateFiles(srcPath))
+        Log("Preparing to process files...");
+        var srcFiles = Directory.EnumerateFiles(srcPath).ToArray();
+
+        var apiDocRootInd = dstPath.LastIndexOf("docs");
+        var apiDocRoot = "/";
+        if (apiDocRootInd != -1)
+            apiDocRoot = dstPath[(apiDocRootInd + 4)..].Replace(Path.DirectorySeparatorChar, '/');
+        if (!apiDocRoot.EndsWith('/'))
+            apiDocRoot += '/';
+
+        var srcFileNames = srcFiles.Select(x => Path.GetFileNameWithoutExtension(x)).ToHashSet();
+
+        Parallel.ForEach(srcFiles, path =>
         {
-            YML2MD yml2md = new();
-            yml2md.Process(path, dstPath);
-        }
+            YML2MD.Process(path, dstPath, apiDocRoot, srcFileNames);
+        });
+        //foreach (var path in srcFiles)
+        //    YML2MD.Process(path, dstPath, dstPath, srcFileNames);
         sw.Stop();
-        Log($"Completed it {sw}!");
+        Log($"Completed in {sw}!");
     }
 
     public static void Assert(bool condition, string? msg = null, [CallerArgumentExpression(nameof(condition))] string? expr = null, [CallerMemberName] string caller = "")