Build Fail Sphinx Error contents.rst not found

Question

I follow the instructions on read the docs but I get this error:

bash Sphinx error: master file /home/docs/checkouts/readthedocs.org/user_builds/mybinders/checkouts/latest/docs/source/contents.rst not found

Do have to you the read the docs yaml file?

Answer 1

If you have your own conf.py file, it overrides Read the Doc's default conf.py. By default, Sphinx expects the master doc to be contents. Read the Docs will set master doc to index instead (or whatever it is you have specified in your settings). Try adding this to your conf.py:

master_doc = 'index'

For more information, check out this issue: https://github.com/rtfd/readthedocs.org/issues/2569