pages.yml

name: Build html using Sphinx and upload to Github-pages

on:
  push:
    branches: [ "main" ]

permissions:
  contents: read

jobs:
  pages:
    runs-on: ubuntu-20.04
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    permissions:
      pages: write
      id-token: write
    steps:
    - name: Checkout
      uses: actions/checkout@v4
    - name: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version: "3.9"
    - name: Install Sphinx
      run: |
        python -m pip install --upgrade pip
        python -m pip install -r requirements-dev.txt
        python -m pip install sphinx
        python -m pip install sphinxcontrib-bibtex
    - name: Build html
      run: sphinx-build -b html ./doc/source/ ./doc/build/
    - name: Setup Pages
      uses: actions/configure-pages@v2
    - name: Upload artifact
      uses: actions/upload-pages-artifact@v1
      with:
        path: ./doc/build/
    - name: Deploy to GitHub Pages
      id: deployment
      uses: actions/deploy-pages@v1