api-doc.yml

name: API documentation
on:
  push:

jobs:
  generate-documentation:
    name: generate-doxygen
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: install dependencies
        run: |
          sudo apt install doxygen graphviz
      - name: prepare-build
        run: mkdir build
      - name: cmake-configuration
        run: cmake -DCMAKE_BUILD_TYPE=Debug ..
        working-directory: ./build
      - name: build-documentation
        run: cmake --build . --target api_doc
        working-directory: ./build
      - name: Deploy to GitHub Pages
        if: github.ref == 'refs/heads/main'
        uses: JamesIves/github-pages-deploy-action@v4.4.3
        with:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          BRANCH: gh-pages # The branch the action should deploy to.
          FOLDER: build/doc/html # The folder the action should deploy.
          TARGET_FOLDER: doc/