...

2026-06-10 21:31:37 -04:00
parent 01a49c1c30
commit 3e80ce78a0
119 changed files with 6234 additions and 8 deletions
@@ -0,0 +1,146 @@
+using System.Net.Http.Json;
+using Markdig;
+using Web.Models;
+
+namespace Web.Services;
+
+public class DocsService
+{
+    private readonly HttpClient _http;
+    private NotesIndex? _index;
+    private static readonly MarkdownPipeline Pipeline = new MarkdownPipelineBuilder()
+        .UseYamlFrontMatter()
+        .Build();
+
+    public DocsService(HttpClient http)
+    {
+        _http = http;
+    }
+
+    public async Task<NotesIndex> GetIndexAsync()
+    {
+        if (_index != null)
+            return _index;
+
+        _index = await _http.GetFromJsonAsync<NotesIndex>("docs/notes-index.json")
+                 ?? new NotesIndex();
+
+        return _index;
+    }
+
+    public async Task<NoteDocument?> GetNoteAsync(string slug)
+    {
+        var index = await GetIndexAsync();
+        var noteInfo = index.Notes.FirstOrDefault(n =>
+            string.Equals(n.Slug, slug, StringComparison.OrdinalIgnoreCase));
+        if (noteInfo == null) return null;
+
+        try
+        {
+            var markdown = await _http.GetStringAsync($"docs/notes/{slug}.md");
+            return ParseDocument(slug, noteInfo.Title, markdown);
+        }
+        catch
+        {
+            return null;
+        }
+    }
+
+    private static NoteDocument ParseDocument(string slug, string title, string markdown)
+    {
+        var doc = new NoteDocument
+        {
+            Slug = slug,
+            Title = title
+        };
+
+        var frontmatterLines = new List<string>();
+        var bodyLines = new List<string>();
+        var inFrontmatter = false;
+        var frontmatterDone = false;
+
+        foreach (var line in markdown.Replace("\r\n", "\n").Split('\n'))
+        {
+            var trimmed = line.Trim();
+            if (!frontmatterDone && trimmed == "---")
+            {
+                if (!inFrontmatter)
+                {
+                    inFrontmatter = true;
+                    continue;
+                }
+                inFrontmatter = false;
+                frontmatterDone = true;
+                continue;
+            }
+
+            if (inFrontmatter)
+                frontmatterLines.Add(line);
+            else if (frontmatterDone || !string.IsNullOrWhiteSpace(line))
+                bodyLines.Add(line);
+        }
+
+        if (frontmatterLines.Count > 0)
+        {
+            var fmHtml = new System.Text.StringBuilder();
+            fmHtml.Append("<table class=\"frontmatter\">");
+            foreach (var line in frontmatterLines)
+            {
+                var colonIdx = line.IndexOf(':');
+                if (colonIdx > 0)
+                {
+                    var key = line[..colonIdx].Trim();
+                    var value = line[(colonIdx + 1)..].Trim().Trim('"');
+                    fmHtml.Append("<tr><td class=\"fm-key\">");
+                    fmHtml.Append(System.Net.WebUtility.HtmlEncode(key));
+                    fmHtml.Append("</td><td class=\"fm-value\">");
+                    fmHtml.Append(System.Net.WebUtility.HtmlEncode(value));
+                    fmHtml.Append("</td></tr>");
+                }
+                else
+                {
+                    fmHtml.Append("<tr><td colspan=\"2\">");
+                    fmHtml.Append(System.Net.WebUtility.HtmlEncode(line.Trim()));
+                    fmHtml.Append("</td></tr>");
+                }
+            }
+            fmHtml.Append("</table>");
+            doc.FrontmatterHtml = fmHtml.ToString();
+        }
+
+        var body = string.Join("\n", bodyLines);
+        body = ConvertWikiLinks(body);
+        doc.HtmlContent = Markdown.ToHtml(body, Pipeline);
+
+        return doc;
+    }
+
+    private static string ConvertWikiLinks(string text)
+    {
+        return System.Text.RegularExpressions.Regex.Replace(
+            text,
+            @"\[\[([^\]]+)\]\]",
+            match =>
+            {
+                var content = match.Groups[1].Value;
+                var parts = content.Split('|');
+                var linkText = parts.Length > 1 ? parts[1].Trim() : parts[0].Trim();
+                var target = parts[0].Trim();
+                var slug = Slugify(target);
+                return $"<a href=\"/docs/{slug}\">{System.Net.WebUtility.HtmlEncode(linkText)}</a>";
+            });
+    }
+
+    public static string Slugify(string title)
+    {
+        var slug = title.ToLowerInvariant()
+            .Replace(' ', '-')
+            .Replace("'", "")
+            .Replace(".", "")
+            .Replace("(", "")
+            .Replace(")", "");
+        slug = System.Text.RegularExpressions.Regex.Replace(slug, @"[^a-z0-9\-]", "");
+        slug = System.Text.RegularExpressions.Regex.Replace(slug, @"-+", "-");
+        return slug.Trim('-');
+    }
+}