docs: nlohmann.json demo

Author: alandefreitas

.github/workflows/ci.yml

@@ -690,13 +690,20 @@ jobs:
           ref: master
           path: fmt
 
+      - name: Clone Nlohmann.Json
+        uses: actions/checkout@v4
+        with:
+          repository: nlohmann/json
+          ref: develop
+          path: nlohmann-json
+
       - name: Patch Demo Projects
         shell: bash
         run: |
           set -euo pipefail
           set -x
           
-          for project in beman-optional fmt; do
+          for project in beman-optional fmt nlohmann-json; do
             src="./examples/third-party/$project"
             dst="./$project"
           
@@ -728,6 +735,8 @@ jobs:
               echo "Number of files in demos/boost-url/$variant/$generator: $(find demos/boost-url/$variant/$generator -type f | wc -l)"
               # beman.optional demo
               mrdocs --config="$(pwd)/beman-optional/docs/mrdocs.yml" --output="$(pwd)/demos/beman-optional/$variant/$generator" --multipage=$multipage --generator="$generator" --log-level=debug
+              # nlohmann-json demo
+              mrdocs --config="$(pwd)/nlohmann-json/docs/mrdocs.yml" --output="$(pwd)/demos/nlohmann-json/$variant/$generator" --multipage=$multipage --generator="$generator" --log-level=debug
               # fmt demo
               mrdocs --config="$(pwd)/fmt/doc/mrdocs.yml" --output="$(pwd)/demos/fmt/$variant/$generator" --multipage=$multipage --generator="$generator" --log-level=debug
               # mrdocs documenting mrdocs demo
@@ -736,7 +745,7 @@ jobs:
           
             # Render the asciidoc files to html using asciidoctor
             if [[ ${{ runner.os }} == 'Linux' ]]; then
-              for project in boost-url beman-optional mrdocs fmt; do
+              for project in boost-url beman-optional mrdocs fmt nlohmann-json; do
                 root="$(pwd)/demos/$project/$variant"
                 src="$root/adoc"
                 dst="$root/adoc-asciidoc"

docs/extensions/mrdocs-demos.js

@@ -130,6 +130,17 @@ function humanizeLibrary(library) {
     {
         return 'Beman.Optional';
     }
+    if (library === 'nlohmann-json')
+    {
+        return 'Nlohmann.JSON';
+    }
+    if (library === 'boost-scope') {
+        return 'Boost.Scope';
+    }
+    if (library === 'fmt') {
+        return 'Fmt';
+    }
+    // Match boost-<library> and convert to Boost.<Library> (capitalized)
     const boostLibrary = library.match(/boost-([\w]+)/);
     if (boostLibrary) {
         const capitalized = boostLibrary[1].charAt(0).toUpperCase() + boostLibrary[1].slice(1);
@@ -143,6 +154,12 @@ function libraryLink(library) {
         return 'https://github.com/boostorg/url[Boost.URL,window=_blank]';
     } else if (library === 'boost-scope') {
         return 'https://github.com/boostorg/scope[Boost.Scope,window=_blank]';
+    } else if (library === 'nlohmann-json') {
+        return 'https://www.github.com/nlohmann/json[Nlohmann.JSON,window=_blank]';
+    } else if (library === 'beman-optional') {
+        return 'https://www.github.com/steve-downey/optional[Beman.Optional,window=_blank]';
+    } else if (library === 'fmt') {
+        return 'https://github.com/fmtlib/fmt[fmt,window=_blank]';
     }
     return humanizeLibrary(library);
 }

examples/third-party/nlohmann-json/docs/mrdocs.yml

@@ -0,0 +1,16 @@
+source-root: ..
+input:
+  - ../include
+exclude:
+  - ../include/nlohmann/detail
+  - ../include/nlohmann/thirdparty
+includes:
+  - ../include
+file-patterns:
+  - '*.hpp'
+include-symbols:
+  - 'nlohmann::**'
+implementation-defined:
+  - 'nlohmann::detail'
+multipage: true
+generator: adoc

examples/third-party/projects.json

@@ -20,6 +20,13 @@
     "branch": "master",
     "config": "doc/mrdocs.yml"
   },
+  {
+    "name": "Nlohmann.Json",
+    "id": "nlohmann-json",
+    "repository": "https://www.github.com/nlohmann/json",
+    "branch": "develop",
+    "config": "docs/mrdocs.yml"
+  },
   {
     "name": "Mr.Docs",
     "id": "mrdocs",