toctree can't find modules.rst in source directory

6,447 views
Skip to first unread message

Jacob Stevens-Haas

unread,
Aug 5, 2019, 5:40:19 PM8/5/19
to sphinx-users
Pretty straightforward error: sphinx looks at the toctree in index, can't find document 'modules'.  Then I get warned that modules.rst isn't in any toctree.  


When running `make html` I get:

Running Sphinx v2.1.2
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 0 source files that are out of date
updating environment: [] 0 added, 1 changed, 0 removed
reading sources... [100%] index
C:\Users\600301\Documents\GitHub\seattle\docs\source\index.rst:9: WARNING: toctree contains reference to nonexisting document ' modules'
looking for now-outdated files... none found
pickling environment... done
checking consistency... C:\Users\600301\Documents\GitHub\seattle\docs\source\modules.rst: WARNING: document isn't included in any toctree
done
preparing documents... done
writing output... [100%] index
generating indices... genindex py-modindex
writing additional pages... search
copying static files... done
copying extra files... done
dumping search index in English (code: en) ... done
dumping object inventory... done
build succeeded, 2 warnings.

index.rst
Welcome to Seattle's documentation!
===================================

.. toctree::
:maxdepth: 2
:caption: Contents:

modules


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
modules.rst
seattle
=======

.. toctree::
:maxdepth: 4

seattle



Dirk Schiller

unread,
Aug 5, 2019, 5:43:48 PM8/5/19
to sphinx...@googlegroups.com
modules.rst is in the source Folder (  C:\Users\600301\Documents\GitHub\seattle\docs\source ) ?

--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/966d6adb-35eb-41e4-9ed1-1b72993c64db%40googlegroups.com.

Jacob Stevens-Haas

unread,
Aug 5, 2019, 5:45:36 PM8/5/19
to sphinx-users
Yeah, it is

Dirk Schiller

unread,
Aug 5, 2019, 5:53:17 PM8/5/19
to sphinx-users
Use thre Spaces: [][][]modules
THe Brackets just Placeholder for this Comment; replace them with Spaces.

Am Montag, 5. August 2019 23:45:36 UTC+2 schrieb Jacob Stevens-Haas:
Yeah, it is

Dirk Schiller

unread,
Aug 5, 2019, 5:57:56 PM8/5/19
to sphinx-users
To be clear: The 'm' of 'modules' must be under the first Colon of ':caption: ...'

Jacob Stevens-Haas

unread,
Aug 5, 2019, 7:16:45 PM8/5/19
to sphinx-users
Success!  Thank you
Reply all
Reply to author
Forward
0 new messages