Add mermaid diagram support to documentation builds

.github/workflows/build.yaml

@@ -254,6 +254,11 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v6
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 'lts/*'
+
       - name: Download all test results
         uses: actions/download-artifact@v7
         with:
@@ -272,6 +277,9 @@ jobs:
         with:
           dotnet-version: 10.x
 
+      - name: Install npm dependencies
+        run: npm install
+
       - name: Install SonarMark from package
         shell: pwsh
         run: |
@@ -297,6 +305,7 @@ jobs:
         run: >
           dotnet pandoc
           --defaults docs/guide/definition.yaml
+          --filter node_modules/.bin/mermaid-filter.cmd
           --output docs/guide/guide.html
 
       - name: Generate PDF with Weasyprint
@@ -310,6 +319,7 @@ jobs:
         run: >
           dotnet pandoc
           --defaults docs/requirements/definition.yaml
+          --filter node_modules/.bin/mermaid-filter.cmd
           --output docs/requirements/requirements.html
 
       - name: Generate Requirements PDF with Weasyprint
@@ -323,6 +333,7 @@ jobs:
         run: >
           dotnet pandoc
           --defaults docs/tracematrix/definition.yaml
+          --filter node_modules/.bin/mermaid-filter.cmd
           --output docs/tracematrix/tracematrix.html
 
       - name: Generate Trace Matrix PDF with Weasyprint
@@ -349,6 +360,7 @@ jobs:
         run: >
           dotnet pandoc
           --defaults docs/quality/definition.yaml
+          --filter node_modules/.bin/mermaid-filter.cmd
           --output docs/quality/quality.html
 
       - name: Generate Code Quality PDF with Weasyprint

.gitignore

@@ -21,6 +21,7 @@ coverage/
 
 # Node.js dependencies
 node_modules/
+package-lock.json
 
 # Generated documentation
 docs/*.pdf

package.json

@@ -0,0 +1,7 @@
+{
+  "private": true,
+  "devDependencies": {
+    "@mermaid-js/mermaid-cli": "11.12.0",
+    "mermaid-filter": "1.4.7"
+  }
+}