readthedocs.org: Missing `sphinx_rtd_theme` required by default when appending `docs/conf.py`

Details

Expected Result

As auto-created readthedocs.org specific configuration define ‘sphinx_rtd_theme’ as html_theme, it is expected that it install the required dependencies. It was doing it until few days.

Actual Result

The build fails because of:

Theme error:
no theme named 'sphinx_rtd_theme' found (missing theme.conf?)

About this issue

  • Original URL
  • State: closed
  • Created a year ago
  • Comments: 15 (9 by maintainers)

Commits related to this issue

Most upvoted comments

The tutorial template is failing the first build with this error for me

Hi, for new projects we aren’t installing the RTD nor other libs by default, see https://blog.readthedocs.com/python-core-requirements-changed/. We recommend that your project installs the proper dependencies explicitly.

ok, followed the above hint… and it gets further after adding the sphinx_rtd_theme to requirements.txt… but now i see

.. autosummary::
   :toctree: generated
...
ERROR: Unknown directive type "autofunction".
...
ERROR: Unknown directive type "autoexception".
.. autoexception:: lumache.InvalidKindError
...
Sphinx error:
root file /home/docs/checkouts/readthedocs.org/user_builds/storyworld0/checkouts/latest/docs/index.rst not found