rebuilding docs

Author: essicolo

.github/workflows/docs.yml

@@ -3,7 +3,7 @@ name: Build and Deploy Sphinx Documentation
 on:
   push:
     branches:
-      - main  # ou le nom de votre branche principale
+      - main  # or your default branch
 
 jobs:
   build-and-deploy:
@@ -22,11 +22,24 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install sphinx sphinx_rtd_theme nbsphinx
+        pip install .
+        pip freeze
+
+    - name: Debug environment
+      run: |
+        pwd
+        ls -R
+        python -c "import pandalchemy; print(pandalchemy.__file__)"
+        python -c "from pandalchemy import methods; print(methods.__file__)"
 
     - name: Build Documentation
       run: |
         cd docs
-        make html
+        sphinx-build -b html . _build/html -v  # Verbose output
+
+    - name: Check build output
+      run: |
+        ls -R docs/_build/html
 
     - name: Deploy to GitHub Pages
       uses: peaceiris/actions-gh-pages@v3

examples/basic-usage.ipynb docs/_examples/basic-usage.ipynb

@@ -1,7 +1,19 @@
 API Reference
 =============
 
+Methods
+-------
+
 .. automodule:: pandalchemy.methods
    :members:
    :undoc-members:
-   :show-inheritance:
+   :show-inheritance:
+
+Individual Functions
+--------------------
+
+.. autofunction:: pandalchemy.methods.select
+.. autofunction:: pandalchemy.methods.where_
+.. autofunction:: pandalchemy.methods.group_by
+
+# Add more functions as needed

docs/api.rst

@@ -9,6 +9,7 @@
 import os
 import sys
 sys.path.insert(0, os.path.abspath('..'))
+print("Python path:", sys.path)
 
 project = 'pandalchemy'
 copyright = '2024, Essi Parent'

docs/conf.py

@@ -16,4 +16,12 @@ documentation for details.
    :caption: Contents:
 
    api
-   examples/basic-usage
+   _examples/basic-usage
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`