rippled/.github/workflows/doxygen.yml

name: Build and publish Doxygen documentation
# To test this workflow, push your changes to your fork's `develop` branch.
on:
  push:
    branches:
      - develop
      - doxygen
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  documentation:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    container: ghcr.io/xrplf/rippled-build-ubuntu:aaf5e3e
    steps:
      - name: checkout
        uses: actions/checkout@v4
      - name: check environment
        run: |
          echo ${PATH} | tr ':' '\n'
          cmake --version
          doxygen --version
          env | sort
      - name: build
        run: |
          mkdir build
          cd build
          cmake -Donly_docs=TRUE ..
          cmake --build . --target docs --parallel $(nproc)
      - name: publish
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: build/docs/html