Set content title

Author: realLiangshiwei

modules/docs/src/Volo.Docs.Domain/Volo/Docs/DocsDomainModule.cs

@@ -21,7 +21,6 @@
 using Volo.Docs.Localization;
 using Volo.Docs.Projects;
 using Volo.Docs.Projects.Pdf.Markdig;
-using Volo.Docs.Projects.Pdf.Markdown;
 
 namespace Volo.Docs
 {

modules/docs/src/Volo.Docs.Domain/Volo/Docs/Projects/Pdf/Markdown/AnchorLinkRenderer.cs renamed to modules/docs/src/Volo.Docs.Domain/Volo/Docs/Projects/Pdf/Markdig/AnchorLinkRenderer.cs

@@ -1,14 +1,16 @@
 using System;
+using System.Collections.Generic;
+using System.Linq;
 using System.Text.RegularExpressions;
 using System.Web;
 using Markdig;
 using Microsoft.Extensions.Options;
 using Volo.Abp.DependencyInjection;
+using Volo.Docs.Documents;
 using Volo.Docs.HtmlConverting;
-using Volo.Docs.Projects.Pdf.Markdig;
 using Volo.Docs.Utils;
 
-namespace Volo.Docs.Projects.Pdf.Markdown;
+namespace Volo.Docs.Projects.Pdf.Markdig;
 
 public class MarkdigPdfDocumentToHtmlConverter : IDocumentToHtmlConverter<PdfDocumentToHtmlConverterContext>, ITransientDependency
 {
@@ -22,7 +24,11 @@ public MarkdigPdfDocumentToHtmlConverter(IOptions<DocsProjectPdfGeneratorOptions
 
     public virtual string Convert(PdfDocumentToHtmlConverterContext converterContext)
     {
-        var htmlContent = global::Markdig.Markdown.ToHtml(NormalizeContent(converterContext.Content), GetPipeline(converterContext.PdfDocument));
+        var htmlContent = Markdown.ToHtml(NormalizeContent(
+                converterContext.Content,
+                converterContext.PdfDocument,
+                converterContext.DocumentParams), 
+            GetPipeline(converterContext.PdfDocument));
         return NormalizeHtmlContent(htmlContent, converterContext.PdfDocument);
     }
 
@@ -34,9 +40,29 @@ protected virtual MarkdownPipeline GetPipeline(PdfDocument pdfDocument)
             .Build(); 
     }
 
-    protected virtual string NormalizeContent(string content)
+    protected virtual string NormalizeContent(string content, PdfDocument pdfDocument, DocumentParams documentParams)
     {
-        return Regex.Replace(content, @"`{3,4}json\s*//\[doc-nav\][\s\S]*?`{3,4}", string.Empty, RegexOptions.IgnoreCase);
+        content = Regex.Replace(content, @"`{3,4}json\s*//\[doc-nav\][\s\S]*?`{3,4}", string.Empty, RegexOptions.IgnoreCase);
+
+        if (pdfDocument.RenderParameters.IsNullOrEmpty())
+        {
+            return content;
+        }
+        
+        var titleLine = content.Split(Environment.NewLine).FirstOrDefault(x => x.TrimStart().StartsWith("#"));
+        if (titleLine == null)
+        {
+            return content;
+        }
+        
+        var paramValues = pdfDocument.RenderParameters.Select(x =>
+        {
+            var documentParam = documentParams.Parameters.FirstOrDefault(p => p.Name == x.Key);
+            return $"{documentParam?.Values[x.Value] ?? x.Value}";
+        });
+
+        var newTitle = $"{titleLine.Trim()} ({string.Join(", ", paramValues)})";
+        return content.Replace(titleLine, newTitle);
     }
 
     protected virtual string NormalizeHtmlContent(string htmlContent, PdfDocument pdfDocument)

modules/docs/src/Volo.Docs.Domain/Volo/Docs/Projects/Pdf/Markdown/AnchorLinkResolverExtension.cs renamed to modules/docs/src/Volo.Docs.Domain/Volo/Docs/Projects/Pdf/Markdig/AnchorLinkResolverExtension.cs

@@ -1,13 +1,18 @@
+using Volo.Docs.Documents;
+
 namespace Volo.Docs.Projects.Pdf;
 
 public class PdfDocumentToHtmlConverterContext
 {
     public string Content { get; set; }
     public PdfDocument PdfDocument { get; set; }
 
-    public PdfDocumentToHtmlConverterContext(string content, PdfDocument pdfDocument)
+    public DocumentParams DocumentParams { get; set; }
+    
+    public PdfDocumentToHtmlConverterContext(string content, PdfDocument pdfDocument, DocumentParams documentParams)
     {
         Content = content;
         PdfDocument = pdfDocument;
+        DocumentParams = documentParams;
     }
 }

modules/docs/src/Volo.Docs.Domain/Volo/Docs/Projects/Pdf/Markdown/MarkdigPdfDocumentToHtmlConverter.cs renamed to modules/docs/src/Volo.Docs.Domain/Volo/Docs/Projects/Pdf/Markdig/MarkdigPdfDocumentToHtmlConverter.cs

@@ -99,7 +99,7 @@ protected virtual async Task<string> ConvertDocumentsToHtmlAsync(List<PdfDocumen
             {
                 var renderedDocument = await RenderDocumentAsync(pdfDocument);
                 var documentToHtmlConverter = GetDocumentToHtmlConverter(Project, pdfDocument);
-                var htmlContent = documentToHtmlConverter.Convert(new PdfDocumentToHtmlConverterContext(renderedDocument, pdfDocument));
+                var htmlContent = documentToHtmlConverter.Convert(new PdfDocumentToHtmlConverterContext(renderedDocument, pdfDocument, DocumentParams));
                 contentBuilder.AppendLine(htmlContent);
             }