no unused template linebreaks

#improvement

Author: alandefreitas

include/mrdocs/Metadata/Javadoc.hpp

@@ -1205,70 +1205,14 @@ tag_invoke(
     v = dom::LazyObject(I, domCorpus);
 }
 
-/** A @details paragraph
-*/
-struct Details final : Paragraph
-{
-    static constexpr auto static_kind = NodeKind::details;
-
-    Details()
-        : Paragraph(NodeKind::details)
-    {}
-
-    auto operator<=>(Details const&) const = default;
-
-    bool
-    operator==(Details const&) const noexcept = default;
-
-    bool equals(Node const& other) const noexcept override
-    {
-        auto* p = dynamic_cast<Details const*>(&other);
-        if (!p)
-        {
-            return false;
-        }
-        if (this == &other)
-        {
-            return true;
-        }
-        return *this == *p;
-    }
-};
-
-/** Map the @ref Details to a @ref dom::Object.
- */
-template <class IO>
-void
-tag_invoke(
-    dom::LazyObjectMapTag t,
-    IO& io,
-    Details const& I,
-    DomCorpus const* domCorpus)
-{
-    tag_invoke(t, io, dynamic_cast<Paragraph const&>(I), domCorpus);
-}
-
-/** Return the @ref Details as a @ref dom::Value object.
- */
-inline
-void
-tag_invoke(
-    dom::ValueFromTag,
-    dom::Value& v,
-    Details const& I,
-    DomCorpus const* domCorpus)
-{
-    v = dom::LazyObject(I, domCorpus);
-}
-
 /** A @see paragraph
 */
 struct See final : Paragraph
 {
     static constexpr auto static_kind = NodeKind::see;
 
     See()
-        : Paragraph(NodeKind::see)
+        : Paragraph(static_kind)
     {
     }
 
@@ -1682,8 +1626,6 @@ visit(
         return visitor.template visit<TParam>();
     case NodeKind::throws:
         return visitor.template visit<Throws>();
-    case NodeKind::details:
-        return visitor.template visit<Details>();
     case NodeKind::see:
         return visitor.template visit<See>();
     case NodeKind::precondition:
@@ -1901,7 +1843,7 @@ tag_invoke(
     Javadoc const& I,
     DomCorpus const* domCorpus)
 {
-    io.defer("details", [&I, domCorpus] {
+    io.defer("description", [&I, domCorpus] {
         return dom::LazyArray(I.blocks, domCorpus);
     });
     if (I.brief)

share/mrdocs/addons/generator/adoc/layouts/wrapper.adoc.hbs

@@ -1,47 +1,27 @@
-{{! The wrapper for single page documentation or symbols in a multipage documentation }}
-{{! Title }}
-{{#if @root.config.multipage }}
-{{! Multipage documentation: symbol is available to the wrapper }}
-[#{{{symbol.anchor}}}]
-{{!
-    This title qualified name does not include links as the Antora
-    UI is not able to render these links in the title.
-
-    Breadcrumbs are included in the symbol template as an alternative.
-}}
-= {{> symbol/qualified-name symbol }}
-{{!
-    Antora does not support relative links to pages in
-    parent directories. Therefore, unlike in HTML templates,
-    links are not relativized.
-
-    However, while Antora interprets xref as relative
-    to the root of the module, these xref are
-    interpreted as relative to the current directory
-    because it has no concept of modules. This means
-    links would be broken with either Antora or Asciidoc.
+{{!--
+    Wraps the documentation for a symbol (multipage) or all symbols (single page).
 
-    Even more, Antora uses the same rule as Asciidoc
-    for breadcrumbs and the page title, where links
-    would also be broken.
+    The {{{contents}}} tag can be used to include the content of the symbol or symbols
+    to be wrapped by this template.
 
-    The solution is to set the relfileprefix attribute,
-    which includes the relative location of the root
-    directory and makes all links relative to it.
+    The multipage mode, the wrapper also receives the symbol object to render the title
+    and the breadcrumbs.
 
-    This relfileprefix affects Asciidoc links, the
-    Antora title, and the Antora breadcrumbs.
+    In the single page mode, the symbol object is not available to the wrapper, but it
+    is available to the symbol template. In this case, the title is simply "Reference".
 
-    See https://docs.asciidoctor.org/asciidoc/latest/macros/inter-document-xref/#mapping-references-to-a-different-structure
-}}
+    As Antora does not support relative links to pages in parent directories, the
+    relfileprefix attribute is set to make all links relative to the root directory.
+    This is only necessary in multipage mode.
+--}}
+{{#if @root.config.multipage }}
+[#{{{symbol.anchor}}}]
+= {{> symbol/qualified-name symbol }}
 :relfileprefix: {{{ repeat "../" (count (remove_prefix symbol.url '/') '/') }}}
 {{else}}
-{{! Single page documentation: symbol is not available to the wrapper }}
 = Reference
 {{/if}}
 :mrdocs:
 
-{{! Content generated with index.hbs }}
 {{{contents}}}
-
-[.small]#Created with https://www.mrdocs.com[MrDocs]#
+{{#>markup/span class="small"}}Created with https://www.mrdocs.com[MrDocs]{{/markup/span}}

share/mrdocs/addons/generator/adoc/partials/javadoc/brief.adoc.hbs

@@ -0,0 +1,3 @@
+{{>javadoc/inline-brief}}
+
+

share/mrdocs/addons/generator/adoc/partials/javadoc/description.adoc.hbs

@@ -0,0 +1 @@
+{{#each .}}{{>javadoc/any-block .}}{{/each}}

share/mrdocs/addons/generator/adoc/partials/javadoc/detail-blocks.adoc.hbs

@@ -1,3 +1 @@
-
-=== {{string}}
-
+{{#> markup/dynamic-level-h level=1 }}{{string}}{{/markup/dynamic-level-h}}

share/mrdocs/addons/generator/adoc/partials/javadoc/heading.adoc.hbs

@@ -1,3 +1,19 @@
+{{!--
+    Renders a heading element with an optional ID attribute.
+
+    This partial generates a heading element (`h1`, `h2`, etc.) based on the provided level.
+    If an ID is provided, it will be included as an anchor for the heading.
+
+    Parameters:
+        - partial block: The content to be rendered inside the heading element.
+        - level: The level of the heading element (1, 2, etc.).
+        - id: An optional ID attribute for the heading element.
+
+    Example:
+        {{> markup/h level=2 id="section-id" }}Section Title{{/markup/h}}
+
+    See: https://mrdocs.com/docs/mrdocs/develop/generators.html#dom_reference
+--}}
 {{#if id}}[#{{{id}}}]
 {{/if}}
 ={{{select level (repeat "=" level) (select @root.config.multipage "==" "=")}}} {{> @partial-block }}

share/mrdocs/addons/generator/adoc/partials/markup/h.adoc.hbs

@@ -1 +1 @@
-| {{> @partial-block }} 
+| {{> @partial-block }}

share/mrdocs/addons/generator/adoc/partials/markup/th.adoc.hbs

@@ -1,2 +1 @@
-{{> @partial-block }}
-
+{{> @partial-block }}

share/mrdocs/addons/generator/adoc/partials/markup/thead.adoc.hbs

@@ -1 +1 @@
-{{> @partial-block }}
+{{> @partial-block }}