reST Toctree#
..toctree:: inserts a Table of Contents (TOC) at the current location.
reST can not interconnect several documents or split documents into multiple output files.
Sphinx uses a custom directive ..toctree::, to add links between the documentation files and table of contents.
How-to#
How-to: Write one or two lines describing the in-depth explanation that follows.
Use admonitions, inline-tabs and other reST tools to get a concise message across.
Reference#
Many other examples follow below, in the How it Looks and reST syntax tabs.
First Example#
Have reST syntax to render how an example looks here.
1Have the reST syntax here; this should mirror the How it Looks tab.
Discussion#
Further Reading#
For further interesting reading on this topic, see Name of the link.