fix(HandlebarsGenerator): relative URLs

Author: alandefreitas

docs/modules/ROOT/pages/generators.adoc

@@ -84,6 +84,17 @@ class MRDOCS_DECL
     dom::Object
     construct(Info const& I) const;
 
+    /** Return a Dom value representing an overload set.
+
+        A @ref Generator should override this member
+        and return suitable @ref dom::Value representing
+        the overload set.
+    */
+    virtual
+    dom::Object
+    construct(
+        OverloadSet const& os) const;
+
     /** Return a Dom object representing the given symbol.
 
         @return A value containing the symbol
@@ -103,19 +114,7 @@ class MRDOCS_DECL
     */
     virtual
     dom::Value
-    getJavadoc(
-        Javadoc const& jd) const;
-
-    /** Return a Dom value representing an overload set.
-
-        A @ref Generator should override this member
-        and return suitable @ref dom::Value representing
-        the overload set.
-    */
-    virtual
-    dom::Object
-    getOverloads(
-        OverloadSet const& os) const;
+    getJavadoc(Javadoc const& jd) const;
 };
 
 } // mrdocs

include/mrdocs/Metadata/DomCorpus.hpp

@@ -1,7 +1,5 @@
 {{! A page when the symbol type is "overloads" }}
-{{#if relfileprefix}}:relfileprefix: {{relfileprefix}}{{/if}}
-[#{{sectionref}}]
-
+[#{{symbol.anchor}}]
 ={{#unless @root.config.multipage}}={{/unless}} {{#if symbol.name}}{{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}{{else}}Unnamed overload set{{/if}}
 
 {{#if symbol.members.[0]}}

share/mrdocs/addons/generator/adoc/layouts/index-overload-set.adoc.hbs

@@ -1,5 +1,2 @@
 {{! The section with a symbol in single page output or the symbol page in multi page output }}
-{{#if relfileprefix}}:relfileprefix: {{relfileprefix}}{{/if}}
-
-[#{{{sectionref}}}]
 {{> symbol symbol=symbol}}

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

@@ -1 +1 @@
-xref:{{{href}}}[{{> @partial-block }}]
+{{#if (starts_with href "#")}}<<{{{href}}},{{> @partial-block }}>>{{else}}xref:{{{href}}}[{{> @partial-block }}]{{/if}}

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

@@ -1,4 +1,5 @@
 {{!-- alias --}}
+[#{{{symbol.anchor}}}]
 ={{#unless @root.config.multipage}}={{/unless}} {{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}
 
 {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/adoc/partials/symbols/alias.adoc.hbs

@@ -1,4 +1,5 @@
 {{!-- concept --}}
+[#{{{symbol.anchor}}}]
 = {{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}
 
 {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/adoc/partials/symbols/concept.adoc.hbs

@@ -1,4 +1,5 @@
 {{!-- enum --}}
+[#{{{symbol.anchor}}}]
 ={{#unless @root.config.multipage}}={{/unless}} {{#if symbol.name}}{{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}{{else}}Unnamed enum{{/if}}
 
 {{{symbol.doc.brief}}}
@@ -18,7 +19,7 @@
 |===
 |Name |Description
 {{#each symbol.members}}
-|xref:{{{ref}}}[`pass:v[{{>types/declarator-id . nolink=true}}]`] | {{~doc.brief}}
+|xref:{{{anchor}}}[`pass:v[{{>types/declarator-id . nolink=true}}]`] | {{~doc.brief}}
 {{/each}}
 |===
 {{/if}}

share/mrdocs/addons/generator/adoc/partials/symbols/enum.adoc.hbs

@@ -1,4 +1,5 @@
 {{!-- enumerator --}}
+[#{{{symbol.anchor}}}]
 ={{#unless @root.config.multipage}}={{/unless}} {{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}
 
 {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/adoc/partials/symbols/enumerator.adoc.hbs

@@ -1,4 +1,5 @@
 {{!-- field --}}
+[#{{{symbol.anchor}}}]
 ={{#unless @root.config.multipage}}={{/unless}} {{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}
 
 {{{symbol.doc.brief}}}