test export of sample draw.io image for documentation

Author: weilanad

.github/workflows/Pipeline.yml

@@ -27,6 +27,29 @@ jobs:
       nvc-version:  ${{ matrix.version }}
       can-fail:     ${{ matrix.can-fail }}
 
+  Extract-images:
+  runs-on: ubuntu-24.04
+  steps:
+    - name: Install draw.io CLI
+      run: |
+        wget https://github.com/jgraph/drawio/releases/download/v24.11.8/drawio-linux-24.11.8.zip
+        unzip drawio-linux-*.zip
+        sudo mv drawio /usr/local/bin/
+
+    - name: Run export script
+      run: |
+        chmod +x ./tools/GitLab-CI/export-drawio.sh
+        ./tools/GitLab-CI/export-drawio.sh "${{ github.event.inputs.drawio_file || 'test.drawio' }}"
+      env:
+        DRAWIO_FILE: "${{ github.event.inputs.drawio_file || 'test.drawio' }}"
+        
+    - name: Upload PNG artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: drawio-exports
+        path: "*.png"
+        retention-days: 1
+
   PublishTestResults:
     uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r6
     needs:

test.drawio

@@ -0,0 +1,13 @@
+<mxfile host="Electron" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/28.1.2 Chrome/138.0.7204.243 Electron/37.4.0 Safari/537.36" version="28.1.2">
+  <diagram name="Seite-1" id="2-pXOjWM6SXTimIP5exn">
+    <mxGraphModel dx="1426" dy="841" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
+      <root>
+        <mxCell id="0" />
+        <mxCell id="1" parent="0" />
+        <mxCell id="UljRTUy-i_8bFENZkZiz-1" value="test" style="rounded=0;whiteSpace=wrap;html=1;" vertex="1" parent="1">
+          <mxGeometry x="250" y="250" width="120" height="60" as="geometry" />
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

tools/GitLab-CI/export-drawio.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+ANSI_LIGHT_GREEN=$'\x1b[92m'
+ANSI_LIGHT_YELLOW=$'\x1b[93m'
+ANSI_LIGHT_BLUE=$'\x1b[94m'
+ANSI_NOCOLOR=$'\x1b[0m'
+
+for file in "$@"; do
+    base_name="${file%.*}"
+
+    # Count how many pages exist per *.drawio file. Use "diagram" tag as indication. Also extract page names.
+    mapfile -t names < <(sed -nE  's/.*<diagram.*name="([^"]*).*/\1/p' "$file")
+    printf "${ANSI_LIGHT_YELLOW}Exporting from '$base_name'${ANSI_NOCOLOR}\n"
+
+    # Export each page as an PNG
+    for i in "${!names[@]}"; do
+        printf "  ${ANSI_LIGHT_BLUE}page '${names[i]}' ...${ANSI_NOCOLOR}\n"
+        drawio --export --page-index $((i+1)) --crop --border 5 --output "${base_name}_${names[i]}.png" "$file" &
+    done
+done
+
+printf "${ANSI_LIGHT_YELLOW}Waiting for exports to finish ...${ANSI_NOCOLOR}\n"
+wait
+
+printf "${ANSI_LIGHT_GREEN}Finished export${ANSI_NOCOLOR}\n"