fix: HTML matches Asciidoc templates

Author: fpelliccioni

share/mrdocs/addons/generator/html/layouts/overload-set.html.hbs

@@ -0,0 +1,17 @@
+{{#if relfileprefix}}<meta name="relfileprefix" content="{{relfileprefix}}">{{/if}}
+<div id="{{#if (is_multipage)}}{{symbol.id}}{{else}}{{symbol.ref}}{{/if}}">
+
+<h1>{{#if symbol.name}}Overload set {{>nested-name-specifier symbol=symbol.parent}}{{symbol.name}}{{else}}Unnamed overload set{{/if}}</h1>
+
+<h2>Members</h2>
+
+{{#each symbol.members as |member|}}
+
+<p>{{member.doc.brief}}</p>
+
+<pre><code class="language-cpp">{{> (concat 'signature' '/' (lookup member 'kind')) symbol=member}};</code></pre>
+<a href="{{ref}}"><em>» more...</em></a>
+
+{{/each}}
+
+</div>

share/mrdocs/addons/generator/html/layouts/single-symbol.html.hbs

@@ -1,3 +1,4 @@
-{{#with symbol}}
-{{> (lookup . 'kind') symbol=.}}
-{{/with}}
+{{#if relfileprefix}}:relfileprefix: {{relfileprefix}}{{/if}}
+[#{{#if (is_multipage)}}{{symbol.id}}{{else}}{{symbol.ref}}{{/if}}]
+
+{{> (concat 'symbols' '/' (lookup symbol 'kind')) symbol=symbol}}

share/mrdocs/addons/generator/html/partials/declarator-after.html.hbs

@@ -1,24 +1,15 @@
-{{#if (eq kind "lvalue-reference")~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}){{~/if~}}
-    {{~>declarator-after pointee-type~}}
-{{~else if (eq kind "rvalue-reference")~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}){{~/if~}}
-    {{~>declarator-after pointee-type~}}
-{{~else if (eq kind "pointer")~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}){{~/if~}}
-    {{~>declarator-after pointee-type~}}
-{{~else if (eq kind "member-pointer")~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}){{~/if~}}
-    {{~>declarator-after pointee-type~}}
-{{~else if (eq kind "array")~}}
+{{#if pointee-type~}}
+    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))}}){{/if~}}
+    {{~>declarator-after pointee-type nolink=nolink~}}
+{{else if (eq kind "array")~}}
     [{{bounds-value}}]
-    {{~>declarator-after element-type~}}
-{{~else if (eq kind "function")~}}
-    ({{~#each param-types~}}
-        {{~>declarator decl-name="" decl-name-targs=""~}}{{~#unless @last}}, {{/unless~}}
-    {{~/each~}})
+    {{~>declarator-after element-type nolink=nolink~}}
+{{else if (eq kind "function")~}}
+    ({{#each param-types~}}
+        {{~>declarator nolink=../nolink~}}{{~#unless @last}}, {{/unless~}}
+    {{/each~}})
     {{~#if cv-qualifiers}} {{cv-qualifiers}}{{/if~}}
-    {{~#if (eq ref-qualifier "lvalue")}} &{{else if (eq ref-qualifier "rvalue")}} &&{{/if~}}
-    {{~#if exception-spec}} {{exception-spec}}{{~/if~}}
-    {{~>declarator-after return-type~}}
-{{/if}}
+    {{#if (eq ref-qualifier "lvalue")}} &{{else if (eq ref-qualifier "rvalue")}} &&{{/if~}}
+    {{#if exception-spec}} {{exception-spec}}{{/if~}}
+    {{~>declarator-after return-type nolink=nolink~}}
+{{/if}}

share/mrdocs/addons/generator/html/partials/declarator-before.html.hbs

@@ -1,33 +1,16 @@
-{{#if (eq kind "builtin")~}}
-    {{#if cv-qualifiers}}{{cv-qualifiers}} {{/if~}}
-    {{name~}}
-{{~else if (eq kind "tag")~}}
-    {{#if cv-qualifiers}}{{cv-qualifiers}} {{/if~}}
-    {{#if parent-type~}}{{>declarator parent-type decl-name="" decl-name-targs=""}}::{{/if~}}
-    {{#if symbol}}{{>xref symbol content=name}}{{else}}{{name~}}{{/if}}
-{{~else if (eq kind "specialization")~}}
-    {{#if cv-qualifiers}}{{cv-qualifiers}} {{/if~}}
-    {{#if parent-type~}}{{>declarator parent-type decl-name="" decl-name-targs=""}}::{{/if~}}
-    {{#if symbol}}{{>xref symbol content=name}}{{else}}{{name~}}{{/if}}
-    {{~>template-args args=args~}}
-{{~else if (eq kind "lvalue-reference")~}}
-    {{~>declarator-before pointee-type~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}({{~/if~}}&
-{{~else if (eq kind "rvalue-reference")~}}
-    {{~>declarator-before pointee-type~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}({{~/if~}}&&
-{{~else if (eq kind "pointer")~}}
-    {{~>declarator-before pointee-type~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}({{~/if~}}*
-    {{~#if cv-qualifiers}} {{cv-qualifiers}}{{/if~}}
-{{~else if (eq kind "member-pointer")~}}
-    {{~>declarator-before pointee-type~}}
-    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))~}}({{~/if~}}
-    {{#if parent-type~}}{{>declarator parent-type decl-name="" decl-name-targs=""}}::*{{/if~}}
-    {{#if cv-qualifiers}} {{cv-qualifiers}}{{/if~}}
-{{~else if (eq kind "array")~}}
-    {{~>declarator-before element-type~}}
-{{~else if (eq kind "function")~}}
-    {{~>declarator-before return-type~}}
+{{#if pointee-type~}}
+    {{~>declarator-before pointee-type nolink=nolink~}}
+    {{#if (or (eq pointee-type.kind "array") (eq pointee-type.kind "function"))}}({{/if~}}
+{{~/if~}}
+{{#if element-type~}}{{~>declarator-before element-type nolink=nolink~}}{{/if~}}
+{{#if return-type~}}{{~>declarator-before return-type nolink=nolink~}}{{/if~}}
+{{#if (eq kind "lvalue-reference")}}&{{/if~}}
+{{#if (eq kind "rvalue-reference")}}&&{{/if~}}
+{{#if (eq kind "pointer")}}*{{/if~}}
+{{#if (eq kind "member-pointer")}}{{>declarator parent-type nolink=nolink}}::*{{/if~}}
+{{#if cv-qualifiers~}}
+    {{#if pointee-type}} {{cv-qualifiers}}{{else}}{{cv-qualifiers}} {{/if~}}
 {{/if~}}
-{{~#if is-pack}}...{{/if~}}
+{{#if (eq kind "decltype")}}decltype({{operand}}){{/if~}}
+{{#if (eq kind "named")}}{{>name-info name nolink=nolink}}{{/if~}}
+{{#if is-pack~}}...{{/if}}

share/mrdocs/addons/generator/html/partials/declarator-id.html.hbs

@@ -0,0 +1,10 @@
+{{#if (and (eq kind "function") (eq class "conversion"))~}}
+    operator {{>declarator return nolink=nolink~}}
+{{else if (eq kind "guide")~}}
+    {{>declarator deduced nolink=nolink~}}
+{{else~}}
+    {{#if (and link.ref (not nolink))}}xref:{{link.ref}}[{{name}}]{{else}}{{name}}{{/if~}}
+    {{#if (or (eq template.kind "explicit") (eq template.kind "partial"))~}}
+        {{>template-args args=template.args nolink=nolink~}}
+    {{/if~}}
+{{/if}}

share/mrdocs/addons/generator/html/partials/declarator.html.hbs

@@ -1,5 +1,5 @@
-<span class="declarator">{{>declarator-before~}}
-{{~#if decl-name}} <span class="declarator-name">{{decl-name~}}</span>
-{{~#if decl-name-targs~}}{{>template-args args=decl-name-targs}}{{~/if~}}
+{{>declarator-before nolink=nolink~}}
+{{~#if decl-name}} {{decl-name~}}
+{{~#if decl-name-targs~}}{{>template-args args=decl-name-targs nolink=nolink}}{{~/if~}}
 {{~/if~}}
-{{~>declarator-after~}}</span>
+{{~>declarator-after nolink=nolink}}