gh-pages.yml

name: Doxygen GitHub Pages Deploy Action

on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  build-documentation:
    runs-on: ubuntu-latest
    container:
      image: "ghcr.io/kamping-site/kamping-ci:2024.2"

    steps:
    - uses: actions/checkout@v3
      with:
          submodules: true
    # This generates a Doxyfile with the appropriate library version
    - name: Configure version
      run: cmake -B build
    # Build the HTML documentation
    - name: Doxygen Action
      uses: mattnotmitt/doxygen-action@edge
      with:
          doxyfile-path: docs/Doxyfile
          working-directory: .
          additional-packages: perl build-base texlive-full biblatex ghostscript
    
    # Deploy the HTML documentation to GitHub Pages
    - name: GH Pages Deployment
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: docs/html/
        enable_jekyll: false
        allow_empty_commit: false
        force_orphan: true
        publish_branch: gh-pages