Fix Doxygen workflow: add Graphviz, clean output, improve Pages deployment

Author: LeoSery

.github/workflows/documentation.yml

@@ -39,6 +39,11 @@ jobs:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v2
 
+      - name: Clean previous artifacts
+        run: |
+          rm -rf generated
+          docker system prune -f
+
       - name: Build documentation files
         uses: docker/build-push-action@v5
         with:
@@ -49,17 +54,24 @@ jobs:
 
       - name: Get generated files
         run: |
-          mkdir generated
-          docker create --name doxygen-generated-files doxygen-generated-files
-          docker cp doxygen-generated-files:/docs/html generated
+          mkdir -p generated
+          docker create --name doxygen-container doxygen-generated-files
+          docker cp doxygen-container:/docs/html generated/
+          docker rm doxygen-container
+
+      - name: Check generated files
+        run: |
+          echo "Checking generated files size and content..."
+          du -sh generated/
+          find generated/ -type l -ls || echo "No symlinks found"
+          ls -la generated/html/
 
       - name: Setup Pages
         uses: actions/configure-pages@v3
 
       - name: Upload artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v3
         with:
-          name: 'github-pages'
           path: 'generated/html'
 
       - name: Deploy to GitHub Pages

docs/Doxyfile

@@ -74,7 +74,7 @@ PROJECT_ICON           =
 # entered, it will be relative to the location where Doxygen was started. If
 # left blank the current directory will be used.
 
-OUTPUT_DIRECTORY       = /docs
+OUTPUT_DIRECTORY       = .
 
 # If the CREATE_SUBDIRS tag is set to YES then Doxygen will create up to 4096
 # sub-directories (in 2 levels) under the output directory of each output format
@@ -2966,7 +2966,7 @@ MAX_DOT_GRAPH_DEPTH    = 0
 # The default value is: NO.
 # This tag requires that the tag HAVE_DOT is set to YES.
 
-DOT_MULTI_TARGETS      = NO
+DOT_MULTI_TARGETS      = YES
 
 # If the GENERATE_LEGEND tag is set to YES Doxygen will generate a legend page
 # explaining the meaning of the various boxes and arrows in the dot generated

docs/doxygen-generator.dockerfile

@@ -1,5 +1,10 @@
 FROM tracto/spark-doxygen-build-tools:latest
 
+# --------------------------------------------
+# Install Graphviz and clean old docs
+# --------------------------------------------
+RUN apt-get update && apt-get install -y graphviz && rm -rf /var/lib/apt/lists/*
+
 # --------------------------------------------
 # Add code and custom documentation
 # --------------------------------------------
@@ -12,6 +17,10 @@ ADD ./Source ./Source
 # Generate documentation
 # --------------------------------------------
 WORKDIR /docs
+
+# Clean any existing documentation
+RUN rm -rf html latex
+
 RUN mv $DOXYGEN_AWESOME_CSS/* .
 RUN mv /sources/docs/* .
 RUN doxygen Doxyfile