Table Nikola 降价中的内容

Table of contents in markdown for Nikola

在过去的几年里,我一直在为我的个人网站使用 Sphinx,并且意识到我更多的是一个包含帖子和几页的博客,并且在过去的几天里转换为 Nikola。我也借此机会切换到 Markdown,因为我将它与 R 和 Stack Overflow 以及其他任何地方一起使用。

我在我的 Sphinx 主题中设置了侧边栏中的本地 table 内容。有一些非常长(超过 10k 字)的帖子可以从本地 table 内容中获益。我看到 Nikola 手册是用 reST 编写的,并使用了 contents 指令。我也想在那些帖子中使用它。

我可以将这几篇文章转换回 reST 并使用 contents 指令,但我想避免这种情况。这能以某种方式实现吗?

已更新

使用 [TOC],这是默认启用的扩展功能。我的第一个回答是对你问题的误解。

第一个答案

使用 Nikola,您可能对 "archive" 选项感兴趣。这是包含您所有帖子的默认页面(可选,按日期分组)。我博客中的示例:https://www.cosmoscalibur.com/archive.html .

Nikola 使用可以在 conf.py 中启用的 Python-Markdown by default. It supports a TOC extension。然后可以在文档中的任何位置使用 [TOC] 标记来获取本地 table 内容。