.. Copy and rename this template in the format reST-doc-title.rst.
.. Update "Template - reST Documentation" with the Documents Title.
.. Update all title-here placeholders with the document title.
.. Update reST-index.rst to include this document.
.. Delete these instructions before pushing the final doc to production.

.. include:: /extras.rst.txt
.. highlight:: rst
.. index:: reST; Toctree
.. _rest-toctree:

============
reST Toctree
============

:sep:`..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* :sep:`..toctree::`,  to add links between
the documentation files and table of contents.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. _how-to-toctree:


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-toctree:

Reference
=========

|

:sep:`Many other examples follow below, in the How it Looks and reST syntax
tabs.`

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. index:: reST directives; Toctree
.. .. _reference-title-here:

First Example
-------------

.. tab:: How it Looks

        Have reST syntax to render how an example looks here.

.. tab:: reST syntax

    .. code-block:: rest
        :linenos:

        Have the reST syntax here; this should mirror the How it Looks tab.

|

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. _discussion-toctree:

Discussion
==========

|

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

|

Further Reading
===============

|

For further interesting reading on this topic, see `Name of the link
<link web address>`__.