nikola - Nikola 的 markdown 目录

Question

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

我已经在我的 Sphinx 主题中设置了侧边栏中的本地目录。有一些非常长（超过 10k 字）的帖子可以从本地目录中受益。我看到 Nikola 手册是用 reST 编写的，并且使用了contents指令。我也想在那些帖子中使用它。

我可以将这几个帖子转换回 reST 并使用 contents 指令，但我想避免这种情况。这可以以某种方式完成吗？

Answer 1

Nikola 默认使用Python-Markdown。它支持一个可以在conf.py. 然后可以在文档中的任何位置使用[TOC]标记来获取本地目录。

Answer 2

更新

使用[TOC]which 是默认启用的扩展程序的一项功能。我的第一个答案是对您的问题的误解。

第一个答案

使用 Nikola，可能您对“存档”选项感兴趣。这是包含所有帖子的默认页面（可选，按日期分组）。我博客中的示例：https ://www.cosmoscalibur.com/archive.html 。