added SearchRecord custom functions for at-blocks

src/html/HTMLWriter.jl

@@ -713,6 +713,91 @@
     return SearchRecord(ctx, navnode; text = mdflatten(node))
 end
 
+
+# For @example blocks
+function SearchRecord(ctx::HTMLContext, navnode::Documenter.NavNode, node::MarkdownAST.Node{Nothing}, element::Documenter.MultiOutput)
+    output_text = ""
+
+    first_child = true
+    for child in node.children
+        if first_child
+            first_child = false
+            continue
+        end
+
+        if isa(child.element, Documenter.MultiOutputElement) && isa(child.element.element, Dict)
+            for mime in [MIME"text/plain"(), MIME"text/markdown"(), MIME"text/html"()]
+                if haskey(child.element.element, mime)
+                    output_text *= string(child.element.element[mime]) * " "
+                    break
+                end
+            end
+        else 
+            output_text *= mdflatten(child) * " "
+        end
+    end
+    return SearchRecord(ctx, navnode; text = output_text)
+end
+
+# For @repl blocks 
+function SearchRecord(ctx::HTMLContext, navnode::Documenter.NavNode, node::MarkdownAST.Node{Nothing}, element::Documenter.MultiCodeBlock)
+    # Extract only output lines (even-numbered children)
+    output_text = ""
+
+    # Process each child, taking only even-numbered ones (outputs)
+    child_index = 0
+    for child in node.children
+        child_index += 1
+        if child_index % 2 == 0  # Even indices are outputs
+            output_text *= mdflatten(child) * " "
+        end
+    end
+    return SearchRecord(ctx, navnode; text = output_text)
+end
+
+# For @eval blocks
+function SearchRecord(ctx, navnode, node::Node, element::Documenter.EvalNode)
+    # For @eval blocks, we only want to index the result, not the source code
+    if isnothing(element.result)
+        return SearchRecord(ctx, navnode; text = "")
+    else
+        return SearchRecord(ctx, navnode; text = mdflatten(element.result))
+    end
+end
+
+function SearchRecord(ctx, navnode, node::Node, element::Documenter.MultiOutputElement)
+    if element.element isa Dict && haskey(element.element, :source)
+        return SearchRecord(ctx, navnode; text = "")
+    end
+
+    return SearchRecord(ctx, navnode, node, element.element)
+end
+
+"""
+Filter function to prevent duplicate search entries.
+"""
+function should_index_for_search(navnode, node, element)
+    if element isa Documenter.MultiOutputElement && 
+       element.element isa Dict && 
+       haskey(element.element, :source)
+        return false
+    end
+
+    if element isa Documenter.MultiCodeBlock && 
+       node.parent !== nothing &&
+       iseven(findfirst(child -> child === node, collect(node.parent.children)))
+        return false
+    end
+
+    if element isa Documenter.EvalNode && 
+       node.parent !== nothing &&
+       node === first(node.parent.children)
+        return false
+    end
+
+    return true
+end
+
 function JSON.lower(rec::SearchRecord)
     # Replace any backslashes in links, if building the docs on Windows
     src = replace(rec.src, '\\' => '/')
@@ -1680,8 +1765,10 @@
 function domify(dctx::DCtx)
     ctx, navnode = dctx.ctx, dctx.navnode
     return map(getpage(ctx, navnode).mdast.children) do node
-        rec = SearchRecord(ctx, navnode, node, node.element)
-        push!(ctx.search_index, rec)
+        if should_index_for_search(navnode, node, node.element)
+            rec = SearchRecord(ctx, navnode, node, node.element)
+            push!(ctx.search_index, rec)
+        end
         domify(dctx, node, node.element)
     end
 end
@@ -1773,15 +1860,16 @@
     @tags a code article header span
 
     # push to search index
-    rec = SearchRecord(
-        ctx, navnode;
-        fragment = Documenter.anchor_fragment(docsnode.anchor),
-        title = string(docsnode.object.binding),
-        category = Documenter.doccat(docsnode.object),
-        text = mdflatten(mdast_node)
-    )
-    push!(ctx.search_index, rec)
-
+    if should_index_for_search(navnode, docsnode, docsnode.object) 
+        rec = SearchRecord(
+            ctx, navnode,
+            fragment = Documenter.anchor_fragment(docsnode.anchor),
+            title = string(docsnode.object.binding),
+            category = Documenter.doccat(docsnode.object),
+            text = mdflatten(mdast_node)
+        )
+        push!(ctx.search_index, rec)
+    end
     return article[".docstring"](
         header(
             a[".docstring-article-toggle-button.fa-solid.fa-chevron-down", :href => "javascript:;", :title => "Collapse docstring"],