diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 869ca407e..db6310d71 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -111,7 +111,7 @@ jobs: python-version: 3 - name: Install dependencies run: | - pip install sphinx + pip install 'sphinx<4' - name: Clone DFHack uses: actions/checkout@v1 with: diff --git a/docs/Documentation.rst b/docs/Documentation.rst index 5e1f8c599..1698038bc 100644 --- a/docs/Documentation.rst +++ b/docs/Documentation.rst @@ -127,6 +127,10 @@ Required dependencies In order to build the documentation, you must have Python with Sphinx version |sphinx_min_version| or later. Python 3 is recommended. +.. warning:: + + Sphinx 4 is currently not supported. See :issue:`1851` for details. + When installing Sphinx from OS package managers, be aware that there is another program called Sphinx, completely unrelated to documentation management. Be sure you are installing the right Sphinx; it may be called ``python-sphinx``,