chore: docs publication pipeline [skip tests]

.github/workflows/publish-documentation.yml

@@ -0,0 +1,33 @@
+name: Publish documentation
+
+on:
+    release:
+        types: [published]
+
+jobs:
+    deploy:
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Installing necessary tools
+              run: |
+                sudo apt-get install doxygen
+                sudo apt-get install graphviz
+            
+            - name: Checkout repository
+              uses: actions/checkout@v3
+              with:
+                fetch-depth: 0
+                submodules: 'recursive'
+
+            - name: Configure Doxygen with CMake
+              run: cmake . -DKDFLIB_GENERATE_DOCS=ON -DKDFLIB_DOCS_ONLY=ON -DKDFLIB_GITHUB_DOCS=ON -DKDFLIB_PRETTY_DOCS=ON
+
+            - name: Generate documentation
+              run: doxygen docs/Doxyfile
+
+            - name: Publish generated content to GitHub Pages
+              uses: JamesIves/github-pages-deploy-action@v4
+              with:
+                folder: doxygen/html
+                token: ${{ secrets.ACCESS_TOKEN }}