From: Marc Fehling <mafehling.git@gmail.com>
Date: Fri, 16 Aug 2024 20:57:16 +0000 (-0600)
Subject: Outsource building documentation into separate github workflow.
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=11e77023d1b5e1e21f350433648811bd0bceb5df;p=dealii.git

Outsource building documentation into separate github workflow.
---

diff --git a/.github/workflows/indent.yml b/.github/workflows/indent.yml
index 456521e474..9dc01bace3 100644
--- a/.github/workflows/indent.yml
+++ b/.github/workflows/indent.yml
@@ -20,23 +20,37 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: 100
-    - uses: ssciwr/doxygen-install@v1
-      with:
-        version: "1.9.6"
     - name: setup
       run: |
         ./contrib/utilities/download_clang_format
-        sudo apt update && sudo apt install graphviz perl texlive-bibtex-extra
-        doxygen --version
     - name: indent
       run: |
         ./contrib/utilities/check_indentation.sh
-    - name: documentation
+
+  doxygen:
+    # build the documentation
+
+    name: doxygen
+    runs-on: [ubuntu-22.04]
+
+    steps:
+    - name: setup
+      run: |
+        sudo apt update
+        sudo apt install graphviz perl texlive-bibtex-extra
+    - uses: ssciwr/doxygen-install@v1
+      with:
+        version: "1.9.6"
+    - uses: actions/checkout@v4
+    - name: build documentation
       run: |
         mkdir build
         cd build
         cmake -DDEAL_II_COMPONENT_DOCUMENTATION=ON -DDEAL_II_DOXYGEN_USE_MATHJAX=ON ..
         make -j 2 documentation
+    - name: check for doxygen errors and warnings
+      run: |
+        cd build
         cat doxygen.log
         # Suppress:
         # warning: Inheritance graph for 'SmartPointer' not generated, too many nodes (138), threshold is 50. Consider increasing DOT_GRAPH_MAX_NODES.
@@ -47,10 +61,13 @@ jobs:
         sed -i '/explicit link request to/d' doxygen.log
         # Remove empty lines
         sed -i '/^$/d' doxygen.log
+        # Check if remaining log is zero size
         ! [ -s doxygen.log ] || exit 1
-        tar -czf doxygen_documentation.tar.gz doc/doxygen
+    - name: compress
+      run: |
+        tar -czf doxygen_documentation.tar.gz build/doc/doxygen
     - name: archive documentation
       uses: actions/upload-artifact@v4
       with:
         name: doxygen_documentation.tar.gz
-        path: build/doxygen_documentation.tar.gz
+        path: doxygen_documentation.tar.gz