chore: generate safe names for section ids

Author: sdkrystian

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

@@ -1,5 +1,5 @@
 {{#if relfileprefix}}:relfileprefix: {{relfileprefix}}{{/if}}
-[#{{#if (is_multipage)}}{{symbol.id}}{{else}}{{symbol.ref}}{{/if}}]
+[#{{sectionref}}]
 
 = {{#if symbol.name}}{{>nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}{{else}}Unnamed overload set{{/if}}
 

share/mrdocs/addons/generator/asciidoc/layouts/single-symbol.adoc.hbs

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

src/lib/Gen/adoc/Builder.cpp

@@ -191,6 +191,8 @@ createContext(
     props.emplace_back("relfileprefix",
         getRelPrefix(I.Namespace.size()));
     props.emplace_back("config", domCorpus->config.object());
+    props.emplace_back("sectionref",
+        domCorpus.names_.getQualified(I.id, '-'));
     return dom::Object(std::move(props));
 }
 
@@ -205,6 +207,8 @@ createContext(
     const Info& Parent = domCorpus->get(OS.Parent);
     props.emplace_back("relfileprefix",
         getRelPrefix(Parent.Namespace.size() + 1));
+    props.emplace_back("sectionref",
+        domCorpus.names_.getQualified(OS, '-'));
     return dom::Object(std::move(props));
 }