Make docs/requirements.txt compatible with toolbox requirements

Re spine-tools/Spine-Toolbox#2342
spine-tools · Oct 5, 2023 · eea4e31 · eea4e31
1 parent d75bc5d
commit eea4e31
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 5 deletions.
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -7,6 +7,7 @@ version: 2
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
+  builder: html
   configuration: docs/source/conf.py
 
 # Optionally build your docs in additional formats such as PDF and ePub

diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -1,5 +1,9 @@
 # Requirements for compiling the documentation
-sphinx >= 2.2.0
-sphinx_rtd_theme >= 0.4.3
-recommonmark >= 0.6.0
-sphinx-autoapi >= 1.1.0
+markupsafe < 2.1  # Jinja2<3.0 tries to import soft_unicode, which has been removed in markupsafe 2.1
+jinja2 < 3.0  # Dagster 0.12.8 requires Jinja2<3.0
+docutils < 0.17
+sphinx < 5.2
+sphinx_rtd_theme
+recommonmark
+astroid < 3.0  # sphinx-autoapi installs the latest astroid. We are not compatible with astroid v3.0
+sphinx-autoapi < 2.1  # 2.1 removed support for sphinx < 5.2.0
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -74,7 +74,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.