Update CI: Add sphinx build

.github/workflows/ci-sphinx.yml

@@ -0,0 +1,45 @@
+name: CI-sphinx
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on push or pull request events but only for the "main" branch
+  pull_request:
+    branches:
+      - 'main'
+      - 'update-*'
+      - 'doc_patch'
+  push:
+    branches: [ 'main', 'doc_patch' ]
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  # This workflow contains a single job called "build"
+  build:
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/[email protected]
+        with:
+          python-version: "3.x"
+
+      - name: Sphinx Build
+        # You may pin to the exact commit or the version.
+        # uses: ammaraskar/sphinx-action@8b4f60114d7fd1faeba1a712269168508d4750d2
+        uses: ammaraskar/[email protected]
+        with:
+          # The folder containing your sphinx docs.
+          docs-folder: docs/
+          # The command used to build your documentation.
+          build-command: make html SPHINXOPTS+="-W --keep-going" #  -n"
+          # Run before the build command, you can use this to install system level dependencies, for example with "apt-get update -y && apt-get install -y perl"
+          pre-build-command: |
+            pwd
+            python --version
+            pip install -r requirements.txt
+            pip install -r docs/requirements.txt

docs/conf.py

@@ -13,7 +13,6 @@
 
 import os
 import sys
-import sphinx_rtd_theme
 
 sys.path.insert(0, os.path.abspath('../'))
 
@@ -41,7 +40,6 @@
     'sphinx_autodoc_typehints',
     #'sphinx.ext.napoleon',
     'sphinx.ext.viewcode',
-    'sphinx_rtd_theme',
     'sphinx.ext.mathjax',
     'numpydoc',
     'myst_parser',

docs/requirements.txt

@@ -1,7 +1,6 @@
 # File: docs/requirements.txt
 
 sphinx==4.4.0
-#sphinx_rtd_theme==1.0.0
 sphinx-book-theme
 readthedocs-sphinx-search==0.1.1
 sphinx-autodoc-typehints

elastica/dissipation.py

@@ -182,7 +182,7 @@ class LaplaceDissipationFilter(DamperBase):
     minimal filtering, and thus negligible effect on the velocities.
     Values in the range of 3-7 are usually recommended.
 
-    For details regarding the numerics behind the filtering, refer to:
+    For details regarding the numerics behind the filtering, refer to [1]_, [2]_.
 
     .. [1] Jeanmart, H., & Winckelmans, G. (2007). Investigation of eddy-viscosity
        models modified using discrete filters: a simplified “regularized variational