docs.yml

name: docs
on:
  push:
    branches:
    - main
    - feature/docs_fix
    - feature/new_docs
jobs:
  build:
    runs-on: ubuntu-20.04
    strategy:
      matrix:
        python: [ 3.9.5 ]
    steps:
    - name: install pandoc
      run: |
        sudo apt-get install pandoc
        sudo apt-get install --reinstall python-pkg-resources
        pip install --upgrade setuptools
        pip install --upgrade distribute
    - uses: actions/setup-python@v2
    - uses: actions/checkout@v2
      with:
        ref: ${{ github.ref }}
        fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
    - name: Build and Commit
      uses: sphinx-notes/pages@v2
      with:
        documentation_path: docs/source
        requirements_path: docs/docs-requirements.txt
    - name: Push changes
      uses: ad-m/github-push-action@master
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        branch: gh-pages