[ghactions] Add publication of website

.github/workflows/python-package.yml

@@ -27,7 +27,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        python -m pip install pytest numpy scipy cvxpy
+        python -m pip install pytest numpy scipy cvxpy sphinx sphinx-rtd-theme nbsphinx
         # if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
     - name: Lint with Ruff
       run: |
@@ -37,3 +37,16 @@ jobs:
       run: |
         pip install -e .
         pytest -m "not triqs"
+
+    - name: Build Documention
+      run: |
+        cd doc
+        make html
+
+    - name: Deploy documentation to website
+      if: matrix.python-version == '3.12' && github.ref == 'refs/heads/main'
+      uses: JamesIves/github-pages-deploy-action@v4
+      with:
+        folder: doc/_build/html
+        branch: github.io
+        target-folder: docs/main