contents (très important)

Table-of-contents markup

The toctree directive, which generates tables of contents of subdocuments, is described in The TOC tree.

For local tables of contents, use the standard reST contents directive.

Example 1

.. contents::
   :local: