.. index::
   pair: sphinx ; contents
   pair: sphinx important; contents

==========================
contents  (très important)
==========================


.. seealso::

   - http://docutils.sourceforge.net/docs/ref/rst/directives.html#table-of-contents



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.



.. _contents:  http://docutils.sourceforge.net/docs/ref/rst/directives.html#table-of-contents


Example 1
==========

::

    .. contents::
       :local:





Example 2
===========


::

    .. contents::
       :depth: 2


.. contents::
   :depth: 2