feat: make search plugin tag inclusion configurable

- Add 'include_tags' config option (defaults to true for backward compatibility)
- When include_tags is false, tags are omitted from search index (empty array)
- Reduces index size on sites with heavy tagging; allows users to toggle tag search
- Add test to verify config option works correctly

All 358 tests passing.

Author: Netdocs

src/Netdocs.Plugins/SearchPlugin.cs

@@ -18,6 +18,7 @@ public sealed class SearchPlugin : IPlugin, IBuildHook
     private string _separator = DefaultSeparator;
     private IReadOnlyList<string> _pipeline = DefaultPipeline;
     private bool _stripBloatElements = true;
+    private bool _includeTags = true;
 
     public string Name => "search";
 
@@ -40,6 +41,11 @@ public void Configure(IPluginContext ctx)
         // that inflate the index without adding search value. Defaults to true.
         if (opts.TryGetValue("strip_bloat_elements", out var strip) && strip is bool b)
             _stripBloatElements = b;
+
+        // `include_tags` controls whether tags are included in the search index. Tags are metadata
+        // (not content) and can inflate the index. Defaults to true for backward compatibility.
+        if (opts.TryGetValue("include_tags", out var incTags) && incTags is bool t)
+            _includeTags = t;
     }
 
     public async Task OnBuildCompleteAsync(SiteContext site, CancellationToken ct)
@@ -49,7 +55,7 @@ public async Task OnBuildCompleteAsync(SiteContext site, CancellationToken ct)
 
         foreach (var page in site.Pages)
         {
-            var tags = ExtractTags(page);
+            var tags = _includeTags ? ExtractTags(page) : [];
             var (intro, sections) = SplitPage(parser, page, _stripBloatElements);
             docs.Add(new SearchDoc(page.Url, page.Title, intro, tags));
 

tests/Netdocs.Core.Tests/SearchPluginTests.cs

@@ -177,4 +177,68 @@ public void SeparatorAndPipeline_AreConfigurable()
         Assert.Equal("[\\s]+", cfg.GetProperty("separator").GetString());
         Assert.Equal(new[] { "trimmer" }, cfg.GetProperty("pipeline").EnumerateArray().Select(e => e.GetString()).ToArray());
     }
+
+    [Fact]
+    public void IncludeTags_DefaultsToTrue()
+    {
+        var page = new Page
+        {
+            SourcePath = "",
+            RelativePath = "index.md",
+            Url = "test/",
+            Title = "Test",
+            HtmlContent = "<h1>Test</h1><p>Content</p>",
+            PlainText = "Test Content",
+            FrontMatter = new Dictionary<string, object?> { ["tags"] = new[] { "tag1", "tag2" } },
+        };
+
+        var index = EmitIndex(page);
+        var doc = index.GetProperty("docs").EnumerateArray().First(d => d.GetProperty("location").GetString() == "test/");
+        var tags = doc.GetProperty("tags").EnumerateArray().Select(t => t.GetString()).ToList();
+
+        Assert.Equal(new[] { "tag1", "tag2" }, tags);
+    }
+
+    [Fact]
+    public void IncludeTags_CanBeDisabled()
+    {
+        var dir = Path.Combine(Path.GetTempPath(), "netdocs-search-" + Guid.NewGuid().ToString("N"));
+        try
+        {
+            var plugin = new SearchPlugin();
+            plugin.Configure(new FakeContext(new Dictionary<string, object?> { ["include_tags"] = false }));
+
+            var config = new SiteConfig { ProjectRoot = dir };
+            var site = new SiteContext
+            {
+                Config = config,
+                Options = new BuildOptions(),
+                LoggerFactory = NullLoggerFactory.Instance,
+            };
+            var page = new Page
+            {
+                SourcePath = "",
+                RelativePath = "index.md",
+                Url = "test/",
+                Title = "Test",
+                HtmlContent = "<h1>Test</h1><p>Content</p>",
+                PlainText = "Test Content",
+                FrontMatter = new Dictionary<string, object?> { ["tags"] = new[] { "tag1", "tag2" } },
+            };
+            site.Pages.Add(page);
+
+            plugin.OnBuildCompleteAsync(site, CancellationToken.None).GetAwaiter().GetResult();
+            var json = File.ReadAllText(Path.Combine(config.AbsoluteSiteDir, "search", "search_index.json"));
+            var index = JsonDocument.Parse(json).RootElement;
+            var doc = index.GetProperty("docs").EnumerateArray().First(d => d.GetProperty("location").GetString() == "test/");
+            var tags = doc.GetProperty("tags").EnumerateArray().ToList();
+
+            // Tags should be empty when include_tags is false
+            Assert.Empty(tags);
+        }
+        finally
+        {
+            if (Directory.Exists(dir)) Directory.Delete(dir, recursive: true);
+        }
+    }
 }