Django中.rst文档的多页html输出

我正在编写一个Django应用程序来提供一些用StructuredText编写的文档。 我有许多用*.rst编写的文档，每个文档都很长，有很多章节、小节等等

使用Django过滤器在一个页面中显示整个文档不是问题，但我更希望在第一个页面上只显示主题索引，链接到一个URL，在那里我可以显示一个单独的部分/小节（我想这需要一些“上一页”、“上一页”、“主页”、“下一页”链接…）。类似于docbook/XML到HTML转换中的“多HTML页面输出”

---

有谁能给我指出一些方向来构建*.rst文档的文档树并解析其中的单个部分，或者建议一种获得类似结果的聪明方法吗？

选择1。包括指向文档其他部分的URL链接

您可以编写index.rst、part1.rst、part2.rst等，并且index.rst具有指向其他部分的链接。这几乎不需要任何工作，只需要仔细规划以确保RST HTML链接是正确的

没有“解析”。您只需将文档分成多个部分。手动

[这似乎太明显了，我不敢说。]

选择2。使用。它可以很好地管理目录和文档间的连接

---

但是，RST的Sphinx扩展不是由Django直接处理的，因此您需要保存Sphinx输出，然后在Django中显示它。我们使用Sphinx的jsonhtmlbuilder（）输出。然后我们通过一个模板呈现这些文档。

谢谢，我一直在考虑选择1，这似乎是其他文档在其他项目中被细分的方式（通常使用Sphinx，我也一直在使用它）。选择2。看起来很有趣，但我想（我正在寻找一种方法）：-将我的文档保存在*.rst中，这样我就可以使用Git管理它们并根据需要生成输出-将所有流程保存在Django中，而无需通过Sphinx Choice 1。看起来简单且易于实现：我将查看我的库，看看我的文档如何适应它。谢谢你的建议。