toctree
La directiva toctree te permite realizar indices de contenidos a otras paginas.
Basicamente se utiliza la de siguiente forma:
.. toctree::
articulo.rst
ayuda.rst
entonces, cuando frontweb se encuentra con esta directiva genera una lista HTML con todos los titulos que encuentre en los archivos articulo.rst y ayuda.rst.
Opciones
toctree incluye una opción para reducir los árboles en caso de que ocupen mucho espacio. La opción es nosubtitles y suprime todos los subtítulos de las listas. Por ejemplo:
.. toctree::
:nosubtitles:
articulo_1.rst
articulo_2.rst
articulo_3.rst