Merge branch 'enh/ci_sphinx' into 'master'

Improvements in documentation automated build

See merge request !391

doc/source/conf.py

@@ -37,7 +37,7 @@ import kwant.continuum  # sphinx gets confused with lazy loading
 sys.path.insert(0, os.path.abspath('../sphinxext'))
 
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.autosummary',
-              'sphinx.ext.todo', 'sphinx.ext.mathjax', 'numpydoc',
+              'sphinx.ext.todo', 'sphinx.ext.mathjax', 'sphinx.ext.napoleon',
               'kwantdoc', 'sphinx.ext.linkcode', 'jupyter_sphinx',
               'sphinxcontrib.rsvgconverter']
 

docker/kwant-latest.yml

@@ -3,6 +3,7 @@ channels:
     - conda-forge
 dependencies:
     - python=3.9
+    - pip
     - numpy
     - scipy
     - tinyarray
@@ -26,7 +27,8 @@ dependencies:
     - pytest-flakes
     - pytest-pep8
     # Documentation building
-    - sphinx
     - numpydoc
     - requests
     - jupyter_sphinx
+    - pip:
+        - git+https://github.com/sphinx-doc/sphinx.git@bedbb8c8259f1b4520ed654ffda3a045c55163d7