docs: website panels use single page

Author: alandefreitas

docs/mrdocs.schema.json

@@ -395,7 +395,7 @@
       "type": "array"
     },
     "tagfile": {
-      "default": "<output>/reference.tag.xml",
+      "default": "<output-dir>/reference.tag.xml",
       "description": "Specifies the full path (filename) where the generated tagfile should be saved. If left empty, no tagfile will be generated.",
       "title": "Path for the tagfile",
       "type": "string"

docs/website/render.js

@@ -67,15 +67,17 @@ target_compile_features(${sourceBasename} PRIVATE cxx_std_23)
     // Run mrdocs to generate documentation
     const mrdocsConfig = path.join(absSnippetsDir, 'mrdocs.yml')
     const mrdocsInput = cmakeListsPath
-    const mrdocsOutput = path.join(absSnippetsDir, 'output')
+    const mrdocsOutput = path.join(absSnippetsDir, 'output', 'reference.html')
     const args = [
         mrdocsExecutable,
         `--config=${mrdocsConfig}`,
         mrdocsInput,
         `--output=${mrdocsOutput}`,
-        '--multipage=true',
+        '--multipage=false',
         '--generator=html',
         '--embedded=true',
+        '--show-namespaces=false',
+        '--tagfile=',
     ];
     const command = args.join(' ');
     console.log(`Running command: ${command}`)
@@ -87,22 +89,19 @@ target_compile_features(${sourceBasename} PRIVATE cxx_std_23)
     }
 
     // Look load symbol page in the output directory
-    const documentationFilename = `${sourceBasename}.html`
-    const documentationPath = path.join(mrdocsOutput, documentationFilename)
-    if (!fs.existsSync(documentationPath)) {
-        console.log(`Documentation file ${documentationFilename} not found in ${mrdocsOutput}`)
+    if (!fs.existsSync(mrdocsOutput)) {
+        console.log(`Documentation file not found in ${mrdocsOutput}`)
         console.log('Failed to generate website panel documentation')
         process.exit(1)
     }
-    panel.documentation = fs.readFileSync(documentationPath, 'utf8');
+    panel.documentation = fs.readFileSync(mrdocsOutput, 'utf8');
 
     // Also inject the contents of the source file as highlighted C++
     const snippetContents = fs.readFileSync(sourcePath, 'utf8');
-    const highlightedSnippet = hljs.highlight(snippetContents, {language: 'cpp'}).value;
-    panel.snippet = highlightedSnippet;
+    panel.snippet = hljs.highlight(snippetContents, {language: 'cpp'}).value;
 
     // Delete these temporary files
-    fs.rmSync(mrdocsOutput, {recursive: true});
+    fs.unlinkSync(mrdocsOutput);
     fs.unlinkSync(cmakeListsPath);
 
     console.log(`Documentation generated successfully for panel ${panel.source}`)

docs/website/snippets/mrdocs.yml

@@ -1,3 +1,5 @@
 source-root: .
 input:
   - .
+show-namespaces: false
+multipage: false

src/lib/Lib/Config.cpp

@@ -427,7 +427,23 @@ struct PublicSettingsVisitor {
                     std::string_view valueSv(value);
                     if (!value.empty())
                     {
-                        res = files::getParentDir(value);
+                        bool const valueIsDir =
+                            [&value]() {
+                                if (files::exists(value))
+                                {
+                                    return files::isDirectory(value);
+                                }
+                                std::string_view const filename = files::getFileName(value);
+                                return filename.find('.') == std::string::npos;
+                            }();
+                        if (valueIsDir)
+                        {
+                            res = value;
+                        }
+                        else
+                        {
+                            res = files::getParentDir(value);
+                        }
                         found = true;
                         return;
                     }

src/lib/Lib/ConfigOptions.json

@@ -300,8 +300,8 @@
         "brief": "Path for the tagfile",
         "details": "Specifies the full path (filename) where the generated tagfile should be saved. If left empty, no tagfile will be generated.",
         "type": "file-path",
-        "default": "<output>/reference.tag.xml",
-        "relative-to": "<output>",
+        "default": "<output-dir>/reference.tag.xml",
+        "relative-to": "<output-dir>",
         "must-exist": false,
         "should-exist": false
       },

util/generate-config-info.py

@@ -170,6 +170,7 @@ def validate_and_normalize_option(option, flat_options):
             # If option is unique directory option of some form
             if flat_option['type'] in ['path', 'dir-path', 'file-path']:
                 reference_directories.append(f'<{flat_option["name"]}>')
+                reference_directories.append(f'<{flat_option["name"]}-dir>')
         if option['relative-to'] not in reference_directories:
             raise ValueError(f'Option "{option["name"]}" has an invalid value for "relative-to"')
         default_paths = option['default']