Nikola 在静态博客中生成 TOC

【问题标题】：Nikola to generate a TOC in static blogNikola 在静态博客中生成 TOC
【发布时间】：2020-03-07 18:42:11
【问题描述】：

我雇用Niloka 来生成静态博客。

一切都很顺利，只是没有自动生成目录，

我参考了“目录”和“内容”的手册，因此找不到解决方案。

您能提供任何提示吗？

【问题讨论】：

对不起，我帮不上忙，但我也认为这些基本东西的文档（或实现）可以改进。

标签： python nikola

【解决方案1】：

在你的 reStructured Text 中包含以下行将插入一个目录。

.. contents::

Nikola 扩展了 reStructuredText (reST)，其中包括两个组件：markup language 和 directives。

reST 标记语言（如 Stack Overflow 中使用的 Markdown）很容易学习。然而，更高级的格式化（如插入图像和目录）是通过指令（也是 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.

【讨论】：