doc.yml

name: Publish Documents

# Controls when the workflow will run
on:
  # Triggers the workflow only on master
  push:
    branches: [ master ]

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

jobs:
  build-and-publish-doc:
    runs-on: self-hosted
    if: github.event.pull_request.draft == false
    steps:
      - uses: roastduck/checkout@main
        with:
          ssh-key: ${{ secrets.CI }}
          submodules: true
          fetch-depth: 0
      - name: Build ffi module in Release
        run: |
          git submodule foreach --recursive git clean -ffdx
          git submodule foreach --recursive git reset --hard
          source /opt/spack/share/spack/setup-env.sh
          spack load python~debug@3.9.12%gcc@10.2.1 java@11 gcc@11.3.0
          source ci-script/prepare-python-environment.sh
          mkdir build
          cmake -B build -S . -DCMAKE_BUILD_TYPE=Release -DFT_WITH_CUDA=OFF -DFT_WITH_MKL=OFF -DFT_WITH_PYTORCH=OFF
          cmake --build build -j
      - name: Run Doxygen
        run: |
          # Doxygen from Spack can't be used together with our Python venv. So run it in this separated step
          source /opt/spack/share/spack/setup-env.sh
          spack load doxygen+graphviz^graphviz+libgd
          doxygen Doxyfile
      - name: Build and publish doc
        run: |
          source /opt/spack/share/spack/setup-env.sh
          spack load python~debug@3.9.12%gcc@10.2.1 java@11 gcc@11.3.0
          source ci-script/prepare-python-environment.sh
          PYTHONPATH=build:python:$PYTHONPATH mkdocs gh-deploy