build-deploy-doxygen.yml

# Run doxygen to generate documentation from C++ code
name: build-deploy-doxygen
# The default build trigger is to run the action on every push for any branch
on:
  workflow_dispatch:
  push:
    branches: 
      - main
  # To run the default repository branch weekly on sunday, uncomment the following 2 lines
  #schedule:
    #- cron: '0 0 * * 0'

jobs:
  build-and-deploy-doxygen:
    name: Build HTML documentation from C++ code
    runs-on: ubuntu-latest
    env:
      GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}

    steps:
    - name: Get repository
      uses: actions/checkout@v3

    - name: Installing build dependencies
      run: |
        sudo apt update
        sudo apt install cmake doxygen gcc git ninja-build

    - name: Building HTML documentation with Doxygen
      run: |
        cmake -S . -B build -G Ninja
        cmake --build build --parallel 16
        mv build/html ./
        mv ./html ./docs

    - name: Push docs to FIMS-docs repo
      uses: dmnemec/copy_file_to_another_repo_action@main
      env:
        API_TOKEN_GITHUB: ${{ secrets.API_TOKEN_GITHUB }}
      with:
        source_file: 'docs'
        destination_repo: 'NOAA-FIMS/FIMS-docs'
        destination_branch: 'main'
        user_email: 'christine.stawitz@noaa.gov' # your email
        user_name: 'Christine Stawitz'       # your login
        commit_message: 'Docs: run Doxygen'