Tell RTD how to install Sphinx.

2025-02-20 17:52:50 +00:00 · 2021-10-28 11:12:17 -04:00 · 2021-10-28 11:12:17 -04:00 · 34d2f74ede
commit 34d2f74ede
parent dd29efc11b
4 changed files with 10 additions and 6 deletions
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@ -0,0 +1,5 @@
+version: 2
+
+python:
+   install:
+   - requirements: docs/requirements.txt
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@ -0,0 +1,4 @@
+sphinx
+docutils<0.18  # https://github.com/sphinx-doc/sphinx/issues/9788
+recommonmark
+sphinx_rtd_theme
--- a/newsfragments/3831.minor
+++ b/newsfragments/3831.minor
--- a/tox.ini
+++ b/tox.ini
@ -217,13 +217,8 @@ commands =
 # your web browser.

 [testenv:docs]
-# we pin docutils because of https://sourceforge.net/p/docutils/bugs/301/
-# which asserts when it reads links to .svg files (e.g. about.rst)
 deps =
-     sphinx
-     docutils==0.12
-     recommonmark
-     sphinx_rtd_theme
+     -r docs/requirements.txt
 # normal install is not needed for docs, and slows things down
 skip_install = True
 commands =