Is a doctrees folder required to display html documents with Sphinx?

Question

When placing documents created using Sphinx, the build folder has two subdirectories: doctrees and html . Do I need both folders to display documents correctly or just the contents of the html folder?

If I really need to, do the contents of the html folder in my public_html and doctrees at the same level (outside the public part of my web server, maintaining the current relative path relation) or something else?

I can not find the answer in the documentation for Sphinx.

Answer 1

The doctrees (or .doctrees ) folder contains the pickled caches of the * .rst source documents, and there is no need to display the documents correctly. To do this, you only need the contents of the html folder.

See http://www.sphinx-doc.org/en/stable/invocation.html#cmdoption-sphinx-build-d .