Как включить локальную оглавление в документ Sphinx?

Я пробовал

.. toc::

Но это не имеет никакого эффекта: в документе ничего не добавлено.

В основном мне нужны ссылки на разделы текущей страницы, которые нужно разместить в определенном месте каждой страницы.

Возможно ли это?

Ответ 1

Я не уверен на 100%, это то, что вы ищете, но может помочь директива .. contents::. По умолчанию он предоставит вам заголовки для всей страницы, где бы вы ни указали директиву. С указанным :local: он будет генерировать локальный TOC для заголовков ниже, где вы укажете директиву (удобна для подстроек).

Подробнее здесь: http://docutils.sourceforge.net/docs/ref/rst/directives.html#table-of-contents