pages.yml

name: pages-build-deployment

on:
  push:
    branches:
      - gh-pages
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: false

env:
  DOXYGEN_VERSION: 1.14.0
  DOXYGEN_CONFIG: "doxygen.config"
  DOXYGEN_RELEASE_PATH: "doxygen"

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout gh-pages for deployment target
        uses: actions/checkout@v5
        with:
          ref: gh-pages
          path: gh-pages

      - name: Setup Pages
        id: pages
        uses: actions/configure-pages@v5

      - name: Build Jekyll
        uses: actions/jekyll-build-pages@v1
        with:
          source: ./gh-pages
          destination: ./_site

      - name: Fix ownership of _site
        run: sudo chown -R $(id -u):$(id -g) ./_site

      - name: Checkout main for doxygen sources
        uses: actions/checkout@v5
        with:
          ref: main
          path: main
    
      - name: Install Doxygen
        run: |
          mkdir -p ./install
          wget https://www.doxygen.nl/files/doxygen-${{ env.DOXYGEN_VERSION }}.linux.bin.tar.gz
          tar -xf doxygen-${{ env.DOXYGEN_VERSION }}.linux.bin.tar.gz -C ./install
          sudo apt-get update && sudo apt-get install -y graphviz

      - name: Build Doxygen docs
        run: ./install/doxygen-${{ env.DOXYGEN_VERSION }}/bin/doxygen ./main/${{ env.DOXYGEN_CONFIG }}
        
      - name: Copy Doxygen output
        run: |
          mkdir -p ./_site/${{ env.DOXYGEN_RELEASE_PATH }}
          cp -r ./html/* ./_site/${{ env.DOXYGEN_RELEASE_PATH }}/

      - name: Upload artifact for deployment
        uses: actions/upload-pages-artifact@v4
        with:
          path: ./_site

  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4