Никола для создания оглавления в статическом блоге

Question

Я нанимаю Niloka для создания статического блога.

Все идет гладко, за исключением того, что оглавление не генерируется автоматически,

Я ссылаюсь на hankbook на "toc" и "content" и поэтому не нахожу решения.

Не могли бы вы дать какие-нибудь подсказки?

Answer 1

Включение следующей строки в реструктурированный текст вставит оглавление.

      .. contents::

Никола расширяет reStructuredText (reST), который включает в себя два компонента: язык разметки и директивы .

Язык разметки reST (например, Markdown, который используется в Stack Overflow) прост в освоении. Однако более сложное форматирование (например, вставка изображений и оглавления) выполняется с помощью директивы (также являющейся частью reST). Например:

      .. figure:: images/myPic.png
    :width: 200
    :alt: A 3-4-5 triangle
    :align: right
    
    This is the caption for my 3-4-5 triangle.
    Indentation is important.