Tweaks and workarounds to fix the doc style locally

doc/conf.py

@@ -53,6 +53,7 @@
  'sphinx_markdown_tables',
  'releases',
  'sphinxcontrib.bibtex',
+ 'sphinx_rtd_theme',
 
  # local extensions
  'md_include',
@@ -231,7 +232,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'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -268,7 +269,7 @@
 #
 html_theme = "sphinx_rtd_theme"
 
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+# html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further. For a list of options available for each theme, see the
@@ -285,6 +286,7 @@
 
 html_context = {
  'css_files': [
+ '_static/css/theme.css',
  '_static/theme_overrides.css', # override wide tables in RTD theme
  ],
  }

doc/readthedocs-pip-requirements.txt

@@ -10,16 +10,17 @@ scipy
 ipykernel
 nbsphinx
 numba
-sphinx_rtd_theme>=0.5.0
+sphinx-rtd-theme
+
 sphinx-markdown-tables
 notedown
-semantic-version==2.6.0
-releases>=1.6.1
+semantic-version
+releases
 sphinxcontrib-bibtex
 nbsphinx-link
 
 # the first release to support f-strings
-pygments >= 2.5.0
+pygments
 
 # previous releases did not render our README badges correctly
-recommonmark>=0.6.0
+recommonmark