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/mybinde

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