Refactor Sphinx workflow to set up Python environment and install dependencies before building documentation

Author: wilsonfreitas

.github/workflows/sphinx.yml

@@ -7,15 +7,29 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
-    - name: Build HTML
-      uses: ammaraskar/sphinx-action@master
+    
+    - name: Set up Python 3.10
+      uses: actions/setup-python@v4
       with:
-        docs-folder: docs/
+        python-version: '3.10'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install poetry
+        poetry install --with docs
+    
+    - name: Build docs
+      run: |
+        cd docs
+        poetry run sphinx-build -b html . _build/html
+    
     - name: Upload artifacts
       uses: actions/upload-artifact@v4
       with:
         name: html-docs
         path: docs/_build/html/
+    
     - name: Deploy
       uses: peaceiris/actions-gh-pages@v4
       if: github.ref == 'refs/heads/main'