我将使用 Django（我来自 Sphinx）管理一些文档，以便更好地控制输出。文档位于 git 存档中的 rst（重组文本）中，使用过滤器在 HTML 中显示它们很简单。我的问题是它们很长，我希望对分页方式有更多的控制，所以我可以在每个 HTML 页面上显示一个部分，对单个部分进行评论等等......
我的目标是能够解析每个文档，创建带有指向单独 HMTL 页面中每个部分的链接的 TOC，其中视图将遍历整个文档以仅在 html 中呈现一个部分。
我知道这主要是 docutils 的问题，我能找到的最有趣的例子是：http ://www.ibm.com/developerworks/library/x-matters24/#code2但它似乎已经过时并且示例在“面向树的处理”部分中，这就是魔法所在，似乎不适用于我的 docutils 版本。文章很好：我可以使用更多相同的主题！
有没有类似于我计划做的事情可以学习，或者有人可以指出我对 docutils 的温和介绍来解析 rst 文档？