Add CurrentUrl and MaxLevel to TocOptions

Readme.md

@@ -154,6 +154,14 @@ Code copied from `AutoIdentifierExtension`, then added some code and options.
 * `aClass`: `string? : default null`
 
   Class attribute for  `a`  element.
+
+* `CurrentUrl`: `string? : default null`
+
+  Current Url for toc items to work on subpages like `/help#anker`
+
+* `MaxLevel`: `int : default 6`
+
+  Maximum heading level to include in the table of content. e.g. set to 2 to only include # and ## headings.
 
 
 

src/Helpers/HeadingInfos.cs

@@ -33,7 +33,7 @@ void renderHtmlMixed(HtmlRenderer renderer, TocOptions options)
                 renderer.Write("<li");
                 if (options.liClass is not null)
                     renderer.Write($" class='{options.liClass}'");
-                renderer.Write($"><a href='#{Id}'");
+                renderer.Write($"><a href='{options.CurrentUrl}#{Id}'");
                 if (options.aClass is not null)
                     renderer.Write($" class='{options.aClass}'");
                 renderer.Write($">{Content}</a></li>");
@@ -70,7 +70,7 @@ void renderHtmlLint(HtmlRenderer renderer, TocOptions options)
 
                 if (!item.IsLocator)
                 {
-                    renderer.Write($"<a href='#{item.Id}'");
+                    renderer.Write($"<a href='{options.CurrentUrl}#{item.Id}'");
                     if (options.aClass is not null)
                         renderer.Write($" class='{options.aClass}'");
                     renderer.Write($">{item.Content}</a>");

src/TocOptions.cs

@@ -55,6 +55,10 @@ public TocOptions()
         /// Classes for ContainerTag, work on ContainerTag is <strong> not null</strong>. 
         /// </summary>
         public string? ContainerClass { get; set; }
+        /// <summary>
+        /// Current Url for toc items to work on subpages like /help.<br/>
+        /// </summary>
+        public string? CurrentUrl { get; set; }
         #endregion
         #region toc tag
         /// <summary>
@@ -102,6 +106,12 @@ public TocOptions()
         /// </summary>
         public string? TitleClass { get; set; }
         #endregion
+        /// <summary>
+        /// Maximum heading level to include in the table of content <em>(default 6)</em>.<br/>
+        /// e.g. set to 2 to only include # and ## headings.
+        /// </summary>
+        public int MaxLevel { get; set; } = 6;
+
         #region toc items
         /// <summary>
         /// Class names for <strong>ul</strong> emement.<br/>
@@ -124,7 +134,11 @@ public TocOptions()
         #endregion
 
         internal void AddHeading(HeadingInfo info)
-            => Headings.Append(HeadingInfos.FromHeading(info));
+        {
+            if (info.Level > MaxLevel)
+                return;
+            Headings.Append(HeadingInfos.FromHeading(info));
+        }
 
     }
 }