api.yml

name: API Documentation

on:
  push:
    branches: [ develop ]
    paths-ignore:
      - ".gitignore"
      - "README.md"
      # ignore CI for other platforms
      - ".github/workflows/android.yml"
      - ".github/workflows/ios.yml"
      - ".github/workflows/linux.yml"
      - ".github/workflows/macos.yml"

jobs:
  build:

    runs-on: ubuntu-latest
    
    steps:
    - name: Checkout Enroute
      uses: actions/checkout@v4
      with:
        submodules: false
        fetch-depth: 0
    - name: Install Doxygen
      uses: ssciwr/doxygen-install@v1
    - name: Generate documentation
      working-directory: doc
      run: |
        doxygen
        mv APIdoc ..
    - name: Publish Documentation
      if: github.event_name == 'push'
      uses: JamesIves/github-pages-deploy-action@v4
      with:
        branch: gh-pages
        folder: APIdoc
        target-folder: APIdoc