CI: Build the documentation

Author: HaoZeke

.github/workflows/ci.yml

@@ -151,6 +151,8 @@ jobs:
       shell: bash
       run: |
         source bin/test_symengine_unix.sh
+        pip install sphinx m2r2 sphinx-autodoc2 sphinx-book-theme
+        sphinx-build docs/ genDocs
       env:
         PYTEST_ADDOPTS: ${{ matrix.PYTEST_ADDOPTS }}
         USE_GLIBCXX_DEBUG: ${{ matrix.USE_GLIBCXX_DEBUG }}
@@ -185,6 +187,12 @@ jobs:
         BUILD_SHARED_LIBS: ${{ matrix.BUILD_SHARED_LIBS }}
         PYTHON_VERSION: ${{ matrix.PYTHON_VERSION }}
 
+    - name: Generate documentation
+      shell: bash
+      run: |
+        pip install sphinx m2r2 sphinx-autodoc2 sphinx-book-theme
+        sphinx-build docs/ genDocs
+
     - name: Deploy Documentation
       if: ${{ (github.ref == 'refs/heads/main' && github.repository == 'Symengine/symengine.py') || (github.ref == 'refs/heads/master' && github.repository == 'Symengine/symengine.py')}}
       uses: peaceiris/actions-gh-pages@v3

bin/test_symengine_unix.sh

@@ -19,4 +19,3 @@ source bin/install_travis.sh
 # Build Python wrappers and test
 cd $PYTHON_SOURCE_DIR
 bin/test_travis.sh
-

docs/conf.py

@@ -17,18 +17,14 @@
 import os
 import sys
 
-sys.path.insert(0, os.path.abspath(".."))
-
-import symengine
-
 # -- Project information -----------------------------------------------------
 
 project = 'symengine'
 copyright = '2021, SymEngine development team <[email protected]>'
 author = 'SymEngine development team <[email protected]>'
 
 # The full version, including alpha/beta/rc tags
-release = symengine.__version__
+# release = symengine.__version__
 
 
 # -- General configuration ---------------------------------------------------
@@ -46,9 +42,13 @@
     "sphinx.ext.duration",  # Shows times in the processing pipeline
     "sphinx.ext.mathjax",  # Need math support
     "sphinx.ext.githubpages",  # Puts the .nojekyll and CNAME files
-    "sphinxcontrib.apidoc",  # Automatically sets up sphinx-apidoc
     # "recommonmark", # Parses markdown
     "m2r2", # Parses markdown in rst
+    "autodoc2",
+]
+
+autodoc2_packages = [
+    "../symengine",
 ]
 
 # Add any paths that contain templates here, relative to this directory.

docs/index.rst

@@ -10,7 +10,7 @@ Symengine Python API Documentation
    :maxdepth: 2
    :caption: Contents:
 
-   source/modules
+   apidocs/index
 
 .. mdinclude:: ../README.md