docs.yml

name: Docs

on:
  #push:
  #  branches-ignore:
  #    - '**'  
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]
  
jobs:
  build:

    runs-on: ubuntu-latest

    steps:
    - name: Requirements
      run: sudo apt update
        && sudo apt install doxygen
        && sudo pip install sphinx
        && sudo pip install sphinx-rtd-theme
        && sudo pip install breathe
        && sudo pip install sphinx-sitemap
    - name: Checkout repo
      uses: actions/checkout@1.0.0
    - name: Build Documentation
      run: cd docs
        && make html
        && cd _build/html
        && touch .nojekyll
    - name: Deploy
      uses: JamesIves/github-pages-deploy-action@releases/v3
      with:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        BRANCH: gh-pages # The branch the action should deploy to.
        FOLDER: docs/_build/html # The folder the action should deploy.