Nikola to generate a TOC in static blog

Question

I am employ Niloka to generate a static blog.

Things go smoothly, except that it did not generate a TOC automatically,

I refer the hankbook for "toc" and "content", and thus not find a solution.

Could you please provide any hints?

Answer 1

Including the following line in your reStructured Text will insert a table of contents.

.. contents::

Nikola is extends reStructuredText (reST) which includes two components: its markup language and directives.

The reST markup language (like Markdown which is used in Stack Overflow) is easy to learn. However, more advanced formatting (like inserting images and table of contents) is accomplished with directives (also part of reST) take option. For example:

.. 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.