feat: embedded option

Like the asciidoc option, this option can be used to generate pages without the surrounding tags to include them in other documentation pages, like the mrdocs website.

Author: alandefreitas

docs/mrdocs.schema.json

@@ -50,6 +50,11 @@
       "title": "Detect SFINAE expressions",
       "type": "boolean"
     },
+    "embedded": {
+      "default": false,
+      "title": "Output an embeddable document, which excludes the header, the footer, and everything outside the body of the document. This option is useful for producing documents that can be inserted into an external template.",
+      "type": "boolean"
+    },
     "filters": {
       "properties": {
         "symbols": {

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

@@ -2,7 +2,7 @@
 {{#if relfileprefix}}:relfileprefix: {{relfileprefix}}{{/if}}
 [#{{sectionref}}]
 
-={{#unless is_multipage}}={{/unless}} {{#if symbol.name}}{{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}{{else}}Unnamed overload set{{/if}}
+={{#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]}}
 
@@ -12,7 +12,7 @@
 
 {{/if}}
 
-=={{#unless is_multipage}}={{/unless}} Synopsis
+=={{#unless @root.config.multipage}}={{/unless}} Synopsis
 
 {{#each symbol.members as | member |}}
 
@@ -23,14 +23,14 @@
 {{/each}}
   
 {{#if symbol.members.[0].doc.description}}
-=={{#unless is_multipage}}={{/unless}} Description
+=={{#unless @root.config.multipage}}={{/unless}} Description
 
 {{symbol.members.[0].doc.description}}
 {{/if}}
 
 {{#with (flattenUnique symbol.members "doc.exceptions" "exception") as |allExceptions|}}
 {{#if (ne (len allExceptions) 0)}}
-=={{#unless is_multipage}}={{/unless}} Exceptions
+=={{#unless @root.config.multipage}}={{/unless}} Exceptions
 
 |===
 | Name | Thrown on
@@ -44,15 +44,15 @@
 {{/with}}
 
 {{#if symbol.members.[0].doc.returns}}
-=={{#unless is_multipage}}={{/unless}} Return Value
+=={{#unless @root.config.multipage}}={{/unless}} Return Value
 
 {{symbol.members.[0].doc.returns}}
 
 {{/if}}
 
 {{#with (flattenUnique symbol.members "doc.params" "name") as |allParams|}}
 {{#if (ne (len allParams) 0)}}
-=={{#unless is_multipage}}={{/unless}} Parameters
+=={{#unless @root.config.multipage}}={{/unless}} Parameters
 
 |===
 | Name | Description {{! TODO: | Type? }}
@@ -66,7 +66,7 @@
 {{/with}}
 
 {{#if symbol.members.[0].doc.preconditions}}
-=={{#unless is_multipage}}={{/unless}} Preconditions
+=={{#unless @root.config.multipage}}={{/unless}} Preconditions
 
 {{#each symbol.members.[0].doc.preconditions}}
 {{.}}
@@ -75,7 +75,7 @@
 {{/if}}
 
 {{#if symbol.members.[0].doc.postconditions}}
-=={{#unless is_multipage}}={{/unless}} Postconditions
+=={{#unless @root.config.multipage}}={{/unless}} Postconditions
 
 {{#each symbol.members.[0].doc.postconditions}}
 {{.}}
@@ -84,7 +84,7 @@
 {{/if}}
 
 {{#if symbol.members.[0].doc.see}}
-=={{#unless is_multipage}}={{/unless}} See Also
+=={{#unless @root.config.multipage}}={{/unless}} See Also
 
 {{#each symbol.members.[0].doc.see}}
 {{.}}

share/mrdocs/addons/generator/adoc/layouts/single-symbol.adoc.hbs renamed to share/mrdocs/addons/generator/adoc/layouts/index.adoc.hbs

@@ -1,5 +1,5 @@
 {{! The section with a symbol in single page output or the symbol page in multi page output }}
 {{#if relfileprefix}}:relfileprefix: {{relfileprefix}}{{/if}}
-[#{{sectionref}}]
 
+[#{{sectionref}}]
 {{> (concat 'symbols' '/' (lookup symbol 'kind')) symbol=symbol}}

share/mrdocs/addons/generator/adoc/layouts/single-footer.adoc.hbs

@@ -0,0 +1,9 @@
+{{! The wrapper for single page documentation or symbols in a multipage documentation }}
+{{#unless @root.config.multipage }}
+= Reference
+:mrdocs:
+{{/unless}}
+{{! Content generated with index.hbs }}
+{{contents}}
+
+[.small]#Created with https://www.mrdocs.com[MrDocs]#

share/mrdocs/addons/generator/adoc/layouts/single-header.adoc.hbs

@@ -1,6 +1,6 @@
 {{! A page when the symbol type is "overloads" }}
 {{#if relfileprefix}}<meta name="relfileprefix" content="{{relfileprefix}}">{{/if}}
-<div id="{{#if (is_multipage)}}{{symbol.id}}{{else}}{{symbol.ref}}{{/if}}">
+<div id="{{#if @root.config.multipage}}{{symbol.id}}{{else}}{{symbol.ref}}{{/if}}">
 
 <h1>{{#if symbol.name}}Overload set {{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}{{else}}Unnamed overload set{{/if}}</h1>