Add doxygen docs to Github Pages

.github/workflows/doxygen.yml

@@ -0,0 +1,84 @@
+---
+name: doxygen
+'on': [push, pull_request]
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  linux-x86_64:
+    name: linux-x86_64
+    runs-on: ubuntu-22.04
+    env:
+      MAKEFLAGS: -j2
+    steps:
+      - name: Configure git
+        run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
+      - name: Check out
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          submodules: recursive
+      - name: Install packages
+        run: |
+          sudo apt-get update -y
+          sudo apt-get install -y --no-install-recommends \
+            cmake \
+            make \
+            fluid \
+            libasound2-dev \
+            libc6-dev \
+            libfftw3-dev \
+            libfluidsynth-dev \
+            libgig-dev \
+            libgtk2.0-0 \
+            libjack-jackd2-dev \
+            liblilv-dev \
+            liblist-moreutils-perl \
+            libmp3lame-dev \
+            libogg-dev \
+            libqt5svg5-dev \
+            libqt5x11extras5-dev \
+            libsamplerate0-dev \
+            libsdl2-dev \
+            libsndfile1-dev \
+            libsoundio-dev \
+            libstk-dev \
+            libsuil-dev \
+            libvorbis-dev \
+            libx11-xcb-dev \
+            libxcb-keysyms1-dev \
+            libxcb-util0-dev \
+            libxft-dev \
+            libxinerama-dev \
+            libxml2-utils \
+            libxml-perl \
+            lsb-release \
+            lv2-dev \
+            portaudio19-dev \
+            qt5-qmake \
+            qtbase5-dev \
+            qtbase5-dev-tools \
+            qtbase5-private-dev \
+            qttools5-dev-tools \
+            qtwayland5 \
+            stk \
+            doxygen
+      - name: Configure
+        run: |
+          source /opt/qt5*/bin/qt5*-env.sh || true
+          cmake -S . -B build $CMAKE_OPTS
+      - name: Build docs
+        run: cmake --build build --target doc
+      - name: Setup Pages
+        uses: actions/configure-pages@v2
+      - name: Upload generated website
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'build/doc/doc/html'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

doc/CMakeLists.txt

@@ -1,7 +1,7 @@
 FIND_PACKAGE(Doxygen)
 
-if(DOXYGEN_FOUND)
-	set(INPUTDIRS 
+if(Doxygen_FOUND OR DOXYGEN_FOUND)
+	set(INPUTDIRS
 		"\"${CMAKE_CURRENT_SOURCE_DIR}../src/core\"
 		\"${CMAKE_CURRENT_SOURCE_DIR}../src/gui\"
 		\"${CMAKE_CURRENT_SOURCE_DIR}../src/tracks\"
@@ -14,7 +14,10 @@ if(DOXYGEN_FOUND)
 		WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
 		COMMENT "Generating API documentation with Doxygen"
 		SOURCES Doxyfile.in)
-endif(DOXYGEN_FOUND)
+else()
+	ADD_CUSTOM_TARGET(doc
+		COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_SOURCE_DIR}/doc_fail.cmake
+		VERBATIM)
+endif()
 
 ADD_SUBDIRECTORY(bash-completion)
-

doc/doc_fail.cmake

@@ -0,0 +1 @@
+message(FATAL_ERROR "Doxygen was not found. Unable to generate docs.")