test export of sample draw.io image for documentation

Author: weilanad

.github/workflows/Pipeline.yml

@@ -27,6 +27,33 @@ jobs:
       nvc-version:  ${{ matrix.version }}
       can-fail:     ${{ matrix.can-fail }}
 
+  Extract-images:
+    export-drawio:
+      runs-on: ubuntu-latest
+    
+      steps:
+        - name: Checkout
+          uses: actions/checkout@v4
+    
+        - name: Make script executable
+          run: chmod +x ./tools/GitLab-CI/export-drawio.sh
+    
+        - name: Run draw.io export in container
+          uses: addnab/docker-run-action@v3
+          with:
+            image: rlespinasse/drawio-export:latest
+            options: -v ${{ github.workspace }}:/data
+            run: |
+              cd /data
+              ./tools/GitLab-CI/export-drawio.sh test.drawio
+    
+        - name: Upload PNG artifacts
+          uses: actions/upload-artifact@v4
+          with:
+            name: drawio-png
+            path: |
+              *.png
+
   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"