Update deployer workflow and docs configuration

Author: kshitij-maths

.github/workflows/sphinx-build.yml

@@ -7,25 +7,25 @@ on:
 
 jobs:
   docs:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
     - name: Setup miniconda
-      uses: conda-incubator/setup-miniconda@v2
+      uses: conda-incubator/setup-miniconda@v3
       with:
         auto-update-conda: true
-        python-version: 3.7
+        python-version: 3.10
 
-    - name: Conda install dependecies
+    - name: Conda install dependencies
       shell: bash -l {0}
-      run: conda install --yes -c conda-forge pythonocc-core=7.4.0 numpy scipy matplotlib vtk nose setuptools coveralls sphinx_rtd_theme sphinx python=3.7
+      run: conda install --yes -c conda-forge pythonocc-core numpy scipy matplotlib vtk nose setuptools coveralls sphinx_rtd_theme sphinx python=3.10
 
     - name: Conda info
       shell: bash -l {0}
       run: conda info
 
-    - name: Conda info
+    - name: Build Documentation
       shell: bash -l {0}
       run: cd docs && sphinx-build -b html -d build/doctrees  --keep-going --no-color -w '/tmp/sphinx-log' source build/html
 
@@ -44,3 +44,13 @@ jobs:
         #deploy_key: ${{ secrets.DEPLOY_PRIVATE_KEY }}
         publish_dir: ./docs/build/html
         allow_empty_commit: true
+
+  release_github: 
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+    - uses: actions/checkout@v4
+    - uses: ncipollo/release-action@v1
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}

docs/source/conf.py

@@ -45,10 +45,10 @@
 ]
 
 intersphinx_mapping = {
-    "python": ("http://docs.python.org/3", None),
-    "numpy": ("http://docs.scipy.org/doc/numpy/", None),
-    "scipy": ("http://docs.scipy.org/doc/scipy/reference/", None),
-    "matplotlib": ("http://matplotlib.sourceforge.net/", None),
+    "python": ("https://docs.python.org/3", None),
+    "numpy": ("https://numpy.org/doc/stable/", None),
+    "scipy": ("https://docs.scipy.org/doc/scipy/", None),
+    "matplotlib": ("https://matplotlib.org/stable", None),
 }
 
 # Add any paths that contain templates here, relative to this directory.
@@ -87,7 +87,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
@@ -133,7 +133,7 @@
 # classes and attributes. As side effects, this option ... ???
 # If false, ... ???.
 # The default is True.
-viewcode_import = True
+# viewcode_import = True
 
 
 # -- Options for HTML output ----------------------------------------------
@@ -149,7 +149,7 @@
 # html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+# html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".