toctree

来源： https://stackoverflow.com/questions/40556423/how-can-i-link-the-generated-index-page-in-readthedocs-navigation-bar

问题 I'm attempting to learn sphinx and am stuck on just the basic examples. I'm being given the following error on a make html in the source directory. Running Sphinx v1.1.3 loading pickled environment... not yet created building [html]: targets for 2 source files that are out of date updating environment: 2 added, 0 changed, 0 removed reading sources... [100%] intro /home/owner/Desktop/doc/index.rst:11: ERROR: Error in "toctree" directive: invalid option block. .. toctree:: :maxdepth: 2 intro

问题 I'm getting the warning: WARNING: document isn't included in any toctree for files that exist in the document because they've been explicitly included. So I have the index file: .. toctree:: :maxdepth: 2 pages/0010-foo pages/0020-bar In the file 0020-bar.rst, I'm specifically including a number of other files, as in: .. contents:: :local: .. include:: /pages/reference-architecture/technical-considerations/0070-baz.rst But when I build the project, I still get a warning that 0070-baz.rst isn't