Last Updated: February 25, 2016
· parente

Tabs cause Sphinx TOC warnings on ReadTheDocs

If your Sphinx doc builds cleanly locally, but fails with unexpected warnings like the following on ReadTheDocs:

/var/build/user_builds/tott/checkouts/latest/doc/sessions/auto.rst:: WARNING: document isn't included in any toctree

check any files containing toctree directives for mixed spaces and tabs. A single out-of-place whitespace element can cause the problem.