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

How it Looks

Have reST syntax to render how an example looks here.

reST syntax

Have 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.